Dokumentacja do kodu źródłowego to dla programisty synonim jednorożca. Większość programistów w małych i średnich firmach widzi ją tylko w filmach SF i japońskich anime, gdzie bohater, przeglądając magiczną książeczkę, naraz łapie, jak sterować ogromnym, skomplikowanym robotem. Bardzo często, współpracując przy jakimś projekcie, spotykałem się z sytuacją, gdzie kod aplikacji nie był udokumentowany, podobnie jak sama aplikacja. Tekst ten jest o tym, jak dokumentacja może ułatwić nam życie, jak udokumentować kod PHP oraz dlaczego powinniśmy taką dokumentację sporządzić.
więcej