Csak egy eszrevetel. Az az igazsag, hogy en nem vagyok gyakorlott programozo, igy lehet hogy az en meglatasaim nem helyesek ebben a temakorben. Azonban nekem az a tapasztalatom, hogy regen rossz, ha utolag allok neki dokumentalni, akkor semmi kedvem nincs mar az egeszhez, es olyan is lesz: kenyszer szulte, szuk, es rovid. Jobb, ha mar fejlesztes kozben definialok idot arra, hogy par dolgot ledokumentaljak a kodban, egyreszt hogy ne keruljon elfelejtesre, masreszt pedig amugy is kell egy kis valtozatossag a kodolas utan. Utana megint kodolok, megint egy kicsit dokumentalok (vagy eppen tesztelek), es igy iteralok. Igy minden feladat egyenlo tempoban halad, a projekthez a dokumentalas szakaszban mar vagy csak a formazas marad, vagy csak a kibovites, pontositas, esetleg a szukseges annotaciok beirkalasa marad (ezekkel se szeretek foglalkozni).
Nyilvan nem akarok beleszolni abba, hogy hogyan fejlesztetek, de igy nektek is konnyebb, nem kell halalba hajszolni magatokat azert, hogy legyen dokumentacio, "csak mert a kozosseg azt akarja". Nektek is jobb, ha van egy atlathato dokumentaciotok, amihez a fejlesztok nyulni tudnak. Minel bonyolultabb egy rendszer, annal nehezebb minden egyes reszet fejben tartani.
Egy fuggveny fole irt masfel sor egyaltalan nem vesz el idot a fejlesztestol, viszont kivalo API dokumentacio lesz belole.
Tenyleg nem akarok ratok eroltetni semmit, de erdemes lenne errol elgondolkodnotok. Szurkolok, hogy egy sikeres keretrendszer szulessen meg a kezetek alatt.
--
Ki oda vagyik, hol szall a galamb, elszalasztja a kincset itt alant. | Gentoo Portal