[SI fejlesztői történet] 10. Dokumentáció az SI projektekben?

SI fejlesztők történetei
#10. Mi a dokumentáció egy SI projektben?

Az SI projektekben a megrendelőnek bizonyítékot kell nyújtani a projekt sikeres megvalósítására dokumentáció formájában.

A javaslattételtől kezdve a képernyődefiníciókon, tervezési dokumentumokon és felhasználói kézikönyveken át a projekt fázisaihoz kapcsolódóan számos dokumentumot kell készíteni a projektjavaslattól a tervezésen, fejlesztésen, tesztelésen, üzembe helyezésen és a későbbi üzemeltetésen keresztül. Ezeket a feladatokat általában az újonc fejlesztők végzik.

A dokumentáció készítése közben néha az ember elgondolkodik, hogy vajon ezért lett-e fejlesztő, vagy irodai dolgozó. Magyarországon is gyakori, hogy a különböző fázisokhoz kapcsolódó dokumentáció elkészítését a projekt végére halasztják. Ennek az az oka, hogy:

• A projekt időtartama rövid, így a lehető leggyorsabban kell elkészíteni, és a dokumentációt úgy kell megírni, hogy hitelesnek tűnjön, hogy a projekt határidőre elkészüljön.
• Bármelyik fázisban készítik el a dokumentumokat, a követelmények úgyis változnak, és módosulnak, ezért gyorsabb, ha mindent elkészítenek, és utólag illesztik hozzá a dokumentációt.

Ironikus módon, bár a sorrend nem megfelelő, ez a módszer az SI kultúrában természetes fejlődési útvonalnak tekinthető.

Számos eszköz létezik a képernyődefiníciók készítéséhez, de előfordul, hogy a kész üzemi képernyőt egyszerűen lefényképezik, és abból készítik el a képernyődefiníciót, ami egyfajta csoda.

Általában a fejlesztők utálják a dokumentációkészítést, de mit tehetnek, hiszen újoncok.

A legkönnyebben elérhető újoncok végzik a dokumentálást. Úgy gondolják, hogy a fejlesztéssel egyelőre nem lehet őket megbízni, de a dokumentációkészítéssel igen.

Ha már egyszer megcsináljuk, akkor a későbbiekben a következő kollégának is meg lehet mutatni, ezért használjuk ki a lehetőséget, és készítsünk minőségi dokumentációt.