[Sviluppatore SI: Storie] 10. Cos'è la documentazione in un progetto SI?

Storia di uno sviluppatore SI
#10. Cos'è la documentazione in un progetto SI?

Nei progetti SI, è necessario presentare la documentazione al cliente come prova che il progetto è stato realizzato correttamente.

A partire dalla proposta, passando per la definizione delle schermate, i documenti di progettazione, il manuale utente, ecc., esistono documenti che devono essere compilati in base alle fasi del progetto, dalla proposta di progetto alla progettazione, allo sviluppo, al test, all'apertura e alla successiva gestione. In genere, questi compiti vengono affidati agli sviluppatori junior.

Mentre si compila la documentazione, a volte ci si chiede se si è diventati sviluppatori per questo, se non sia piuttosto un lavoro d'ufficio. Inoltre, in Corea del Sud, è frequente che la documentazione da compilare per ogni fase venga concentrata poco prima della fine del progetto. I motivi sono i seguenti.

• I tempi del progetto sono brevi, quindi è necessario realizzarlo il più rapidamente possibile e creare una documentazione presentabile per completare il progetto entro i tempi previsti.
• Comunque, anche se creata fase per fase, le richieste cambiano e vengono aggiunte, quindi è più veloce creare tutto e poi adattare la documentazione, piuttosto che crearla e modificarla continuamente.

Ironia della sorte, anche se l'ordine è errato, è un metodo che si è evoluto naturalmente nella cultura SI coreana.

Esistono molti strumenti per creare la definizione delle schermate, ma si possono vedere scene incredibili in cui la definizione delle schermate viene creata catturando gli screenshot delle schermate operative già completate.

In genere, gli sviluppatori odiano la redazione della documentazione, ma cosa ci si può fare se si è alle prime armi?

I nuovi assunti, essendo i più facilmente manipolabili, vengono incaricati della documentazione. In pratica, poiché non si possono subito affidare compiti di sviluppo, vengono assegnati compiti di redazione di documenti.

Comunque, se tocca a noi farlo, potremo farlo fare anche al nostro successore, quindi cogliamo l'occasione per farlo bene.