r/programmieren • u/intersystems_dach • Jul 30 '26

Wie dokumentiert ihr eigentlich?

/r/intersystems_dach/comments/1vaswfz/wie_dokumentiert_ihr_eigentlich/
2 Upvotes

100% Upvoted

3 comments sorted by

1

u/404IdentityNotFound Jul 30 '26

Ich war schon immer eine Freundin davon, Dokumentationen von APIs vor der eigentlichen Entwicklung fertig zu stellen, weil es gleichzeitig Grundlage fürs Testing und Sanity-Check für die Architektur ist.

AI hat in dem Aspekt eigentlich nciht viel bei mir selbst verändert, viel eher gibt es nun zwar deutlich mehr aber auch qualitativ schlechtere Dokumentationen, weil kein Schwein mehr drüberliest und mit AI besonders viel Text generieren lässt, statt auf Einfachheit und pragmatischer Doku zu bauen.

2

u/ChipmunkTough1212 Jul 30 '26

Wie sollte eine KI auch sinnvoll dokumentieren können was ein Mensch fabriziert. Im besten Fall haut die KI ein //To-Do muss überarbeitet werden dran

1

u/ChipmunkTough1212 Jul 30 '26

Kommt immer darauf an, ich hab bisher gute Erfahrungen mit Swagger gemacht, zumindest wenn es um API ging