SI fejlesztő történetek
#10. Mi a dokumentáció az SI projektekben?

Az SI projektekben dokumentációt kell benyújtani az ügyfeleknek, hogy bizonyítsák a projekt sikeres végrehajtását.

A javaslattól kezdve a képernyődefiníción át a tervezési dokumentumokon és a felhasználói kézikönyveken keresztül a projekt különböző fázisaihoz tartozó dokumentumokat kell elkészíteni a projekt javaslatától a tervezésen, a fejlesztésen, a tesztelésen, a megnyitáson és az üzemeltetésen keresztül, amelyeket általában az újonc fejlesztők végeznek.

A dokumentáció elkészítése során az embernek néha kétségei támadnak, vajon ezért lett fejlesztő, vagy inkább irodai dolgozó. Magyarországon gyakori, hogy a projekt zárása előtt rövid idővel készülnek el a különféle fázisok dokumentációi, ennek oka pedig a következő:

• A projekt időtartama rövid, ezért a lehető leggyorsabban el kell készíteni a projektet, a dokumentumokat pedig úgy kell megcsinálni, hogy úgy tűnjenek, mintha készültek volna, a határidőn belül végrehajtva a projektet.
• Akárhogy is csináljuk, a követelmények továbbra is módosulnak és kiegészülnek, ezért ahelyett, hogy minden egyes fázisban elkészítenénk őket, jobb, ha előre elkészítjük őket, és utána illesztjük őket a módosításokhoz.

Ironicus, hogy ez a rossz sorrend, de a magyar SI kultúrában ez a természetes evolúció(?) eredménye.

Sokan készítenek képernyődefiníciós eszközöket, de láthatunk olyan csodálatos jeleneteket, ahol a kész üzemi képernyőt szövegképpé alakítják át a képernyődefiníciós dokumentáció elkészítéséhez.

Általában a fejlesztők nem kedvelik a dokumentációt, de mit tehetünk, te újonc vagy.

A legkönnyebben kezelhető újoncok vállalják a dokumentációs feladatokat. A lényeg, hogy nem fogják rögtön fejlesztési feladatokkal megbízni, ezért inkább dokumentációval.

Akkor is, ha te csinálod, biztosan meg kell majd tanítanod az utódot, ezért a lehetőség adva van, hogy mindent megtegyél.