Impostazione di massima

Questo sistema di documentazione è stato creato nei primi anni di vita di AR snc. Si basa sul sistema adottato in AA & Co. denominato Method-1. Il sistema descrive un metodo standard di analisi e sviluppo dei sistemi informativi. Compende due tipi di manuali:

• Manuali che descrivono le attività di sviluppo.
• Manuali che descrivono la documentazione.

Attività

Le attività di sviluppo procedono a cascata con un certo paralelissmo tra le fase ma senza ricicli significativi. Il metodo suddivide le diverse attivita in fasi, blocchi e infine singole attività. Le tre fasi di sviluppo --- che denotano tre tipi di progetti --- sono:

1. Pianificazione dei sistemi.
2. Disegno del sistema.
3. Installazione.

Ogni fase viene descritta da un manuale che descrive conve deve essere effettuato il lavoro per completare quella fase. Il manuale presenta un flow chart di riferimento che descrive tutte le attivita previste. Le attività vengono raggruppate in blocchi omogenei. Per ciascuna attività il manuale riporta:

1. Il nome dell'attività. Il nome consiste in una sigla di tre leggere che indica il blocco di attività all'interno di ciascuna fase. Le tre lettere sono seguite da un numero progressivo che indicvidua la specifica attività. Ad esempio il blocco architettura tecnica --- che appartiene alla fase di disegno--- comprende le seguenti attività:
• DTE1, Architettura tecnica
• DTE2, Sisegno Tecnico
• STE1, Test e Conversioni
• STE2, Definizione delle risorse necessarie
2. Obiettivi dell'attività.
3. Il riepilogo della documentazione usata o prodotta. Vengono elencati tutti i documenti con l'indicazione se il documento è utilizzato in:
• Output, Quando viene prodotto da questa attività.
• Input, quando viene consultato.
• Input/Output, quando viene consultato e/o aggiornato.
4. I singoli passi che devono essere effettuati per completare l'attività. Per ciascun passo vine riportata di nuovo la documentazione utilizzata.

Documentazione

Tutta la documentazione citata dai tre manuali di attività viene documentata da un'apposito manuale. Ogni attività indica i documenti che vengono prodotti e ogni documento ha una xref alle attività dove viene utilizzato. Per ogni documento i manuali riportano:

1. Il nome del documento. Questo è formato da tre lettere seguite da tre numeri. Le tre lettere --- come vedremo in seguito --- raggruppano i documenti appartenenti alla medesima famiglia.
2. L'obiettivo del documento.
3. Le circostanze nelle quali deve essere prodotto.
4. Se il documento va archiviato e la durata del documento. Alcuni documenti sono da considerarsi work in progress e vengono eliminati quando sono esaurita esaurite le attività di sviluppo che li utilizzano. Altri documenti sono da considerarsi permanenti e faranno parte della documentazione del sistema.
5. Un elenco delle attività che utilizzano questi documenti.
6. Una breve indicazione sul contenuto.
7. Uno o più esempi realistici del documento richiesto.