"Az igazi programozó programokat ír, nem dokumentációt. " - Egyetértetek?

A dokumentációra semmi szükség - amíg három napig egyfolyában a gép előtt ülsz és írod a kódot. De ha fél év múlva újra használnod kell a kódodat vagy esetleg másét, és nincs dokumentálva, akkor valószínűleg az idő több, mint felét azzal fogod tölteni, hogy próbálod megérteni a kódot. Tehát a dokumentáció egy jó és hasznos dolog, de nem kell túlzásba vinni. (amikor kb. 100 sornyi kódról kell 12 oldal dokumentációt írni, az nem a hasznos formája a dokumentálásnak)

Tehát a jó programozó meg tudja írni a programot, és újrafelhasználhatóvá is tudja tenni azt.

Persze kell dokumentáció, de azt nem a programozónak kéne megírni. 1 (vagy kevés) fős projecteken persze rá hárul a feladat, de egyébként jobb ha nem a programozó készíti. Többféle doksi van. Van amit az ügyfél ad, ezt nyilván az ügyfél írja (esetleg egy kapcsolattartóval közösen átírják, mert az eredeti doksi úgysem jó). Aztán vannak architektek, jobb esetben tőlük jön az a dokumentáció, ami alapján a programozó megírja a kódot. Tehát én egyetértek veled. A programozó feladata dokumentációk alapján megírni a programot. (Persze a szükséges helyeken kommentezni kell, de ezt sem szabad túlzásba vinni, de ezt én nem tekintem dokumentációnak. Ha te a kommentezést is annak tekinted, akkor félreértettem, elnézést)

Persze az is előfordulhat, hogy a programozónak valami javaslata van, valami nem úgy van a doksiban, ahogy jó lenne, akkor ezt az architekttel közösen kijavítják. (Ha az ügyféltől jövő doksiban értelmetlen vmi, akkor azt pedig jelzi, és jobb esetben azt is javítják)

Az igazi programozó olyan kódot ír, amely már maga a dokumentáció. Persze esetenként mégis kell hozzá egy extra dokumentáció. A jó programozó ezt megírja.

A jó programozó:

- előre eltervezi az időbeosztását, és határidő-becsléseket ad

- igyekszik igazodni a kereteihez

- atomikusan verziózza a kódját

- minden kódot atomikus egységekre bont

- minden atomikus egységet tesztel (99%-os test coverage)

- minden atomikus egységhez készít dokumentációt (saját maga), kivéve ha a dokumentáció triviális (ez az ideális eset)

És a fejlesztői dokumentáció készítésében a csapat valamennyi programozója egységesen vesz részt, ugyanis ideális esetben semmilyen kód nem kerül kommitolásra dokumentáció nélkül

Szó szerint azt akartam írni, hogy baromság, erre látom, hogy az első is ezt válaszolta.

Huzamosabb ideje szívok egy programmal, aminek a fejlesztője ezt gondolta, és csúnyákat gondolok rá.

"Csak hiszi magáról, hogy tud, de mégsem."

Tök mindegy, előbb-utóbb úgyis lesz egy munkahelye, ami beleveri az agilis viselkedést.