[SI Ontwikkelaar Verhaal] 10. Wat is documentatie in een SI-project?

SI-ontwikkelaarverhaal
#10. Wat is documentatie in een SI-project?

In een SI-project moet je documenten indienen bij de klant als bewijs dat je het project goed hebt afgerond.

Vanaf de offerte tot en met het schermdefinitiedocument, het ontwerpdocument, de gebruikershandleiding, enz., zijn er documenten die moeten worden geschreven afhankelijk van de projectfase, van projectvoorstel tot ontwerp, ontwikkeling, testen, en na de opening tot en met de operatie. Meestal zijn het de beginnende ontwikkelaars die hiervoor verantwoordelijk zijn.

Tijdens het schrijven van documenten vraag je je wel eens af of je dit nu echt wilde met je carrière als ontwikkelaar. Ben ik nu een administratief medewerker? In Zuid-Korea wordt de documentatie per fase vaak pas vlak voor het einde van het project gedaan. De reden hiervoor is als volgt:

• Omdat de projectperiode kort is, wordt alles zo snel mogelijk gemaakt en wordt de documentatie er 'mooi' uit laten zien om het project binnen de gestelde tijd af te ronden.
• Hoe dan ook, de vereisten zullen worden toegevoegd en gewijzigd, zelfs als je de documentatie fase per fase maakt. Daarom is het sneller om alles te maken en het aan te passen aan de documentatie dan om het te maken en aan te passen.

Ironisch genoeg is dit de manier waarop het in de Zuid-Koreaanse SI-cultuur is geëvolueerd, hoewel de volgorde verkeerd is.

Er zijn veel tools om schermdefinitiedocumenten te maken, maar je kunt getuige zijn van een wonderbaarlijke scène waarbij een schermdefinitiedocument wordt gemaakt door een schermafbeelding van het voltooide werkende scherm te maken.

Ontwikkelaars vinden het over het algemeen verschrikkelijk om documenten te schrijven, maar wat kun je eraan doen? Je bent nieuw.

De meest onervaren nieuwe medewerkers worden verantwoordelijk gesteld voor de documentatie. Ze kunnen nieuwkomers toch nog geen ontwikkeltaken geven, dus laten ze maar documenten schrijven.

Aangezien ik het toch moet doen, kan ik het later ook aan mijn opvolger doorgeven. Dus grijp de kans aan om het goed te doen.