Dokumentation - eines meiner Lieblingsthemen :-D
Allgemein PM
Im aktuellen Java-Magazin 06/2010 Seite 74 habe ich folgendes gefunden ->
Das, was in der Softwareentwicklung erstellt wird, der Sourcecode nämlich, ist bereits ein lesbares Dokument.
Es beschreibt die Software sehr präzise und kann bei guter Versionierung auch nicht abweichen.
Viele andere Disziplinen würden sich wünschen, ihre Produkte direkt aus der Dokumentation (lesbaren Dokumenten) erzeugen zu können.
Deswegen ist alles, was im Softwareentwicklungsprozess "Dokumentation" genannt wird, immer zusätzliche Dokumentation - und da muss man sich schon genau fragen, was und für wen sie erstellt wird.
Es wird immer noch zu Dokumentation erstellt, die nur in unpräziser Form Dinge wiederholt, die schon besser im Sourcecode stehen.
Jol, was soll ich dazu noch sagen
Gruß JJR
Kategorie Im aktuellen Java-Magazin 06/2010 Seite 74 habe ich folgendes gefunden ->
Das, was in der Softwareentwicklung erstellt wird, der Sourcecode nämlich, ist bereits ein lesbares Dokument.
Es beschreibt die Software sehr präzise und kann bei guter Versionierung auch nicht abweichen.
Viele andere Disziplinen würden sich wünschen, ihre Produkte direkt aus der Dokumentation (lesbaren Dokumenten) erzeugen zu können.
Deswegen ist alles, was im Softwareentwicklungsprozess "Dokumentation" genannt wird, immer zusätzliche Dokumentation - und da muss man sich schon genau fragen, was und für wen sie erstellt wird.
Es wird immer noch zu Dokumentation erstellt, die nur in unpräziser Form Dinge wiederholt, die schon besser im Sourcecode stehen.
Jol, was soll ich dazu noch sagen
Gruß JJR