Esperienza NetSim

I documenti originali di NetSim, che esistono tuttora, furono preparati sulla falsa riga dei documenti della contabilità. Si adottò cioè la stessa struttura e all'interno di questa i medesimi indici.

Si presentò subito il problema che i documenti di dettaglio (conversazioni, mappe e stampe) si rivelarono impossibili da tenere aggiornati. Inoltre il volume prodotto era ingestibile dall'utente finale ed esistevano vari dubbi circa la sua utilità.

Con la crescita del sistema esplose anche il documento logico. Infatti il manuale SimFun (funzioni del sistema) raggiunse, nel 1994, le 300 pagine. A quel punto si decise di spezzarlo. Ma l'operazione di spezzatura non fu mai conclusa.

Abbandonati i documenti di dettaglio che elencavano tutte le stampe e tutte le mappe si creò una struttura di documentazione per sotto-sistemi. Ogni documento doveva contenere la logica funzionale del sotto-sistema, le istruzioni all'utente e le mappe e stampe coinvolte. Base di tale documentazione doveva essere la spezzatura di net-sim. Questo progetto nato nel 1994 non è ancora stato terminato.

A questo punto sono nati diversi sistemi paralleli di documentazione tra cui ricordiamo:

1. Documenti Describe su argomenti grossi. Delle specie di monografie tra cui le segnalazioni, l'icu, il D461, le scritture contabili, ecc.
2. Il data base notes net-sim, nato e vissuto in almeno due versioni.
3. Il data base notes segnalazioni.
4. Il data base notes euro.
5. Il data base notes delle richieste di sviluppo.
6. La posta elettronica.
7. Gli interventi di assistenza.

Questa enorme dispersione di documenti porta a concludere che NetSim è essenzialmente documentato. Ogni cosa importante è stata sicuramente scritta da qualche parte. Il problema è localizzarla.

Vi sono diverse osservazioni che si possono trarre da questa esperienza:

1. Quando un sistema cresce oltre certe dimensioni anche la documentazione che lo riguarda diventa parimenti complessa e variegata.
2. Il sistema Word processor crolla in fase di manutenzione. Infatti costringe il manutentore a trovare nei vari manuali la cosa che è stata cambiata. Correggere i manuali, e se il cambiamento non è localizzato, la correzione può comportare un'intervento sulla struttura del manuale.
3. Ma quando il manuale non è stato ancora prodotto non si sa proprio dove scrivere e cosa scrivere. L'ipotesi che avendo modificato un dettaglio di un sotto-sistema è necessario documentare l'intero sotto-sistema per trovare collocazione al dettaglio modificato non è realistica. Fino a quando la documentazione non è in gran parte completa difficilmente può essere mantenuta. Quando è stata finalmente completata è obsoleta in quanto non mantenuta.