A partire dal 20 aprile 2006 i documenti DAR relativi alle release devono essere inseriti in una nuova vista dei database DAR:
9. Varie \ REL, illustrata qui di seguito.
Nei vari database DAR tutti i documenti relativi a release recenti sono stati convertiti e appaiono nella nuova vista. Per inserire nuovi documenti è quindi sufficiente utilizzare la vista in oggetto e non più la vista originale.
NB: Per impedire inserimenti errati è stato aggiunto un controllo nell'input che inibisce il salvataggio di documenti "REL" nella vista "AMM".
I documenti contenuti in questa vista sono identici ai precedenti documenti release, contenuti nella vista Varie\AMM, salvo per quanto segue:
Le zone di input della descrizione della release sono quattro, chiaramente indicate da un separatore:
- Testata (Header). Questa zona deve contenere
- la tabella di testata standard
- indicazioni riguardanti release collegate
- Nuove funzionalità:
- avvertimenti riguardanti l'esecuzione di conversioni
- la descrizione delle nuove implementazioni (NB: senza l'intestazione "implementazioni", senza l'elenco breve Contenuto della release)
- Correzioni : la descrizione delle correzioni (NB: senza l'intestazione "correzioni")
- Commenti interni AR: testo che non deve essere reso visibile ai clienti
Nella formattazione dei documenti occorre tenere presente che verrà effettuata la stampa tramite DAR, quindi in particolare:
- non sono ammessi link. In ogni caso i link non saranno disponibili nella stampa.
- non si devono copiare pezzi di menu o di mappe direttamente in HTML; piuttosto fare un ALT-Print e inserire un'immagine. Se si vuole inserire solo un pezzo di immagine si può usare Paint o altro tool grafico
- per copiare una maschera di testo è necessario inserirla dentro una tabella 1 x 1 e usare il courier.
- non devono esserci paragrafi tutti rossi o tutti bold, altrimenti il DAR li prende come titoli. Nei vari paragrafi delle funzionalità, i paragrafi bold vanno sostituiti con una cosa tipo "Attenzione: blablablabla ". Si veda in questo documento http:/dar/rs/out/html/auto/AMM.RS.R014-019.html il paragrafo relativo al rendiconto di gestione
- I messaggi del tipo "attenzione, questa release prevede una conversione", che originariamente si mettevano in alto tutti in rosso, ora vanno messi all'inizio delle zona "Nuove funzionalità" in un paragrafo apposito intitolato "Attenzione" e nel testo la descrizione della conversione. Si veda questo documento http:/dar/rs/out/html/auto/AMM.RS.R016-010.html dove parla della conversione dei collocamenti
- Non si mette il riepilogo del contenuto della release, come facevo io in RS, perchè il riepilogo viene da solo facendo l'indice del manuale
- Le "Altre release collegate" vanno messe nella testata. Eventuali frasi come "Attenzione, richiede l'installazione della libreria xxxx vanno tolte
- Vanno attentamente rispettati i livelli di dimensione dei font utilizzati nei titoli dei vari paragrafi (tutti i paragrafi di pari livello devono avere lo stesso font). Consigliabile mettere i titoli Rossi font 18 non bold. Eventuali sottotitoli hanno font minore. Per i titoli conviene usare i bottoni previsti sul bordo superiore della form der documento DAR.
- Tutti i testi "courier", pezzi di codice, pezzi di file INI, pezzi di CSV o altro, vanno messi in tabelle 1x1 a sfondo bianco, font courier. Occhio soprattutto i frammenti di ini (se ne trovano parecchi sparsi qua e là)
- Quando l'implementazione è relativa ad una richiesta, nel titolo va messo (in coda, non all'iniizio del titolo) , la dicitura " - Rich. xxxx"
e-mail