amm.rel: Release software, situazione attuale

Andrà nella categoria pio.dcl

Attualmente i database Notes interessati sono di due tipi: Database Dar Prodotti, Database Dar Clienti. Inoltre esistono documenti di rilascio prodotto su supporto esterno (Word) prelevando dati dai database Dar prodotti / clienti.

Database DAR prodotti / Database DAR clienti

Tutti i documenti relativi a rilasci del software presso i clienti (sia che si tratti di pacchetti che di release personalizzate cliente) si trovano nelle viste AMM con categoria REL.

Questi documenti contengono un testo composto di 3 parti:

Testata

Una testata standard qui illustrata:

dcl	AMM: Amministrazione del progetto
dtd	DCV -- Documento con versioni
Nome	Il nome ha il formato "sys.Rnnn-sss" che rappresenta il nome di una release. Dove: La stringa sys sta per il nome del sistema. La stringa nnn sta per il numero maior di release. La stringa sss sta per il numero minor di release. Ad esempio: arl.r003.000, rs.r012.012, rs~ambro.r015.128.
Titolo	Descrizione breve dell'argomento trattato
Categoria	Rientra nella categoria rel.
Revisione	Non usata.

Descrizione funzionalità

Un testo contenente

1. Avvertimenti sulle eventuali conversioni, precedenze da rispettare in fase di installazione, ecc... (poche righe)
2. Descrizione delle nuove funzionalità con esempi di maschere video, ecc...

Elenco correzioni

Un testo contenente un elenco di malfunzionamenti corretti nell'ambito della release in questione.

Database Release AR

Nel database Release AR si trova una copia di ogni documento relativo alle release pubblicate sul sito stesso.

La pubblicazione delle release sul sito attualmente effettua una copia del campo Body del documento relativo alla release interessata, dal database DAR del sistema (o della procedura cliente) al database release.

Documenti di rilascio ai clienti

Attualmente si danno due casi

• Documenti descrittivi del rilascio vengono preparati manualmente dal singolo account tramite lavoro di copy / paste dal database DAR in documenti word o in altro supporto
• Non viene preparato un documento, e i clienti producono la documentazione leggendo sul sito AR i documenti relativi alle release che intercorrono tra quella installata e quella che stanno per installare.

Problemi riscontrati

1. La ripetizione di alcune parti della documentazione relativa a release precedenti in quelle successive
2. In certi casi si riscontra la documentazione di rilasci già effettuati. Questa prassi deve essere eliminata.
3. Osservazioni sui singoli sistemi:
1. GL: La documentazione è insufficiente
2. AMS+: la documentazione è spesso ridondante, ma si preferisce lasciare così.
3. NetSim: la documentazione è normalmente appropriata salvo lacune in alcuni settori (in genere dipende da chi ha scritto il documento)
4. Per i moduli "opzionali" si è notato che questi sono talvolta descritti in modo eccessivamente dettagliato nella release di "introduzione", mentre talvolta manca una descirizone. La pratica corretta dovrebbe essere di inserire un richiamo a documento più dettagliato, abbastanza generico ma tale da destare l'interesse di eventuali nuovi acquirenti.
5. E' necessario un meccanismo di revisione dei documenti in modo da "bloccare" le modifiche dopo la pubblicazione - in ogni caso a carico di un utente con capacità di "amministratore" del prodotto.