PHPDoc - http://www.phpdoc.de/
 
Warum Dokumentation?

Aus Skripten sind in den letzten Jahren Webapplikationen geworden. PHP nimmt mit Version 4 den Anlauf zum erwachsen werden. Mit dem gestiegenem Codeumfang wird die Verwendung von Bibliotheken zur Pflicht.

Gute Bibliotheken sind:

  • flexibel und leistungsfähig
  • leicht erweiterbar
  • aber vor allem: dokumentiert
Dokumentation entscheidet über Akzeptanz von Code und damit über den (kommerziellen) Erfolg.

Nicht vergessen werden darf der Wartungsaspekt - wie oft wird Code verworfen, nur weil ein Programmierer die Firma verläßt?

 
Inhalt << Was ist PHPDoc?  |  Arten von Dokumentation >>

 @copyright Ulf Wendel <ulf.wendel@phpdoc.de>, @sponsored by NetUSE AG