Trascrizine presentazione di JPA

Storia

Un'esperienza seria di documentazione su carta era stata fatta i Domenichelli. Sulla carta si creavano tanti documenti separati che si referenziavano l'uno con l'altro.

E' comodo poter "prendere appunti" e lavorare a più mani. Ne deriva la necessità di poter spezzare i documenti.

Una volta che si è creata una "nuvola di documenti" occorre uno strumento per produrre HTML e PDF. Lo strumento è il DAR, che è uno strumento di publishing.

Una esigenza era quella di sganciarsi da formati particolari per i documenti (tipo Word, Describe, etc) e si è scelto per questo SGML.

La prima esperienza con linguaggi di markup era stata la libreria ARLIB32 documentata in HMTL. Il passaggio a SGML rende i documenti "leggibili" e trattabili da programmi e consente di presentarli in modi differenti.

Dall'SGML all'HTML si utilizzano pesantemente i fogli stile; per la produzione dei PDF si utilizza il TEX, un processore batch che crea documenti.

La definizione dei fogli stile HTML è stato un lavoro semplice, la definizione delle macro TEX è stato un lavoro serio.

Si tenga presente che negli anni era stata accumulata una grande esperienza su come si presenta un documento cartaceo e possiamo sicuramente affermare che i documenti cartacei prodotti dal DAR sono di una elevata qualità tipografica, sicuramente molto meglio di quanto possa fare a mano un utente, anche se attento.

L'obiettivo del DAR attualmente è quello di essere a supporto dello sviluppo. A seguire sarà a supporto degli account. Solo alla fine sarà per l'utente. I documenti utente di tpo "come di fa" normalmente non sopravvivono più di due settimane in un sistema in continua evoluzione.

Definizioni

Il DCL serve a segmentare lo spazio nomi, rappresenta il "macro-argomento", indica la categoria a cui un documento appartiene.

• REQ: requisiti, leggi, interviste, modelli. Un modello descrive una realtà da un certo punto di vista,, indipendentemente dal modo in cui sarà gestita. Si pensi ad esempio ad un'obbligazione, vista e descritta da:
• chi la emette
• chi la compra
• chi la colleziona

sono tutti modelli differenti della stessa realtà

• DSG: analisi, come funziona il sistema, quali sono i componenti, da dove arrivano i dati, dove vanno. Es. pag. 52 di intro.pdf
• MAN: solitamente si fa un'analisi e si presenta all'utente; per questo motivo i MAN sono dentro al disegno logico. In realtà sono documenti a sè stanti. In un manuale è importante l'ordine in cui si organizzano i documenti, cercando di fornire una lettura sequenziale. Quando si parla di un MAN si intende una raccolta organizzata di documenti conecepita per essere letta in sequenza
• DST: documenti di disegno tecnico scritti a mano in notes. Gli altri documenti tecnici sono generati in automatico dai sorgenti
• SYS: suddivide la procedura in sottosistemi, nei quali c'è una pluralità di componenti e una uniformità di obbiettivo. La definizione dei sistemi è la prima cosa che si fa quando si documenta una procedura: si effettua una suddivisione in aree per mappare la procedura. Tutti i documenti automatici sono associati ad un sistema.
• DSU: è il disegno utente, cioè come è stato progettato il prodotto per l'utente. Si dice come l'utente interagisce con il sistema, si progettano i ciclim con lo scopo di progettare i programmi in modo che chiedano all'utente le cose giuste al momento giusto.
• AMM: documenti vari

Il DTD indica il tracciato record del documento, il formato dei contenuti. I DTD pià usati

• CAT: all'interno del DCL si definiscono le categorie, che servono a trovare i documenti e a suddividerli. Le categorie devono essere definite con molta attenzione. Il DTD CAT serve a creare documenti categoria in cui descriverne l'uso, serve per fare l'help sulle categorie definite
• DCV: documento con versioni, il nome è un po' infelice ma sta ad indicare che si possono tenere le varie versioni di ciascun documento. Sono tutti i documenti di contenuto
• MAN: originariamente era usato solo per fare i manuali finiti. Poi si sono fatti i MAN di MAN, per poter fare piccole raccolte di documenti con o senza una descrizione di cappello.

Obbiettivi

Il primo obbiettivo è quello di addestrare lo sviluppo, il secondo obbiettivo è di poter fare analisi.

Si vuole documentare Antimafia, fondo, GL, Netsim.

La documentazione viene fatta a livelli; al primo livello si fa il censimento, si definiscono i sistemi, si documentano i tracciati.

Bisogna poi avere un posto dove elencare i manuali "buoni", sia i nuovi PDF che come "catalogo" dei vechci documenti (word o altro) esistenti.

Note utili

I documenti DOC o PDF ricevuti dai clienti possono essere messi nei DB Notes attaccati a dei documenti discussione, nel DCL giusto o nel RIS.