Teljes inline dokumentációs komment blokkokat (docblock-ok)
kell készíteni. A dokumentációs blokkok PEAR-csomagokkal kapcsolatos
részletezését lásd a Kézikönyv kódolási szabályainak
Példa Fájl és a
Fejléc komment blokkok
fejezeteiben.
További információ a
phpDocumentor weboldalán érhető el.
Dokumentálásnál általános szabály, hogy amiről nem kívánunk leírást
készíteni ("Nem akarom kipróbálni és dokumentálni..."), arról
épphogy érdemes kommentet készíteni, mielőtt elfelejtjük hogyan működik.
Mind a C-stílusú kommentek (/* */), mind a C++ stílusúak (//) használata
elfogadott. A Perl/shell-stílusú kommentek használata szigorúan ellenjavallt.
