Előélet: http://hup.hu/node/125041
Elkezdem dokumentálni. Nem mintha értenék hozzá de kell(ene).
Két érv hangzott el a dokumentálásra:
Csak így lehet másokat is megnyerni: De nagyon úgy tűnik így sem.
Befektetett munka nélkül nincs eredmény: Ez is elég szar érv, ha azt veszem, hogy erre a projektre havonta legalább 100órát elcseszek. Ennél többet sem a munkahelyem, sem a családom nem tolerálna, az ízületeim meg már most sem díjazzák.
Amit viszont nem említett senki:
Egy okból mégis csak jó, ha megkísérlünk olyan szándékkal dokumentálni, hogy azt más is megértse. Ehhez ugyanis le kell lassítani, és egy kicsit körbenézni, mit is lapátoltunk itt össze?
Ilyenkor más "megvilágításban" látjuk a dolgokat.
Sajnos egy egyszemélyes projektnél, ha kitalálsz egy marhaságot, akkor nincs aki erről felvilágosít. Aztán egyrészt szívatjuk magunkat, másrészt az egész kupac átláthatatlanabb lesz a szükségesnél.
Először bizonytalan voltam, hogy érdemes-e újra végigmenni az egészen, mivel már szinte minden, a hibás koncepcióból fakadó problémát megoldottam. Csináltam a GitHub-on egy elágazást, és tettem egy kísérletet. Mivel a módosításnál eddig a legtöbbet a Del gombot használtam, most már biztos vagyok benne, hogy megéri végigcsinálni. Sokkal tisztább, szárazabb érzés :).
Nem csak arra jó a dokumentáció készítés, hogy legyen másnak olvasnivalója, hanem jó okot ad a lassításra, és arra, hogy azt is észrevegyük amit eddig nem (akartunk?).