Come scrivere la documentazione?

Ghepardo · 14-06-2005, 17:34

Ragazzi, volevo chiedervi dei piccoli consigli sul come dovrebbe essere organizzata/strutturata la documentazione di un software. Devo scrivere la documentazione di un progettino che sto facendo per un'esame all'università, ma nessuno ci ha mai spiegato come dovrebbe essere fatta.

Spero voi possiate aiutarmi a capire.

E' fatto in java quindi includerà le javadoc e ci siamo...ma il resto ?

Alvaro Vitali · 14-06-2005, 18:14

Ma devi farla in modo rigoroso utilizzando un linguaggio di modellazione tipo UML e quindi hai progettato il software passando per tutti gli stadi Analisi, Design etc... o solo fornire una documentazione che descriva ciò che hai fatto?
Mi sembra strano che chiedano una documentazione senza averti spiegato di cosa si tratta, di che esame si tratta?

Ghepardo · 14-06-2005, 20:43

progetto di reti di calcolatori.

no, non abbiamo progettato il software con uml etc, il progetto riguarda una directory condivisa quindi cera poco da progettare con uml.

cmq non deve essere proprio rigorosa...

Alvaro Vitali · 14-06-2005, 22:27

Messa in questi termini credo che ti debba compilare una documentazione scritta che copra su per giù questi paragrafi:

- Titolo

- Obiettivi
- Linguaggi e strumenti utilizzati
- Istruzioni (tipo come avviare il server ed i client)
- Protocollo utilizzato
- Descrizione dettagliata
-- Il Server
-- Il Client

Ioa llegherei un diagramma di flusso alla buona giusto per una schematizzazione della comunicazione client server dove mettere in parallello il flow della comunicazione.
Tipo col server che fa socket->bind->listen-> ->accept->send->recive
ed il client in parallelo che socket -> connect ecc...ecc.. ovviamente relativo alla tua applicazione...
Che ne dici?
Ciao!

recoil · 15-06-2005, 10:45

di che l'hai scritta in latex, fa sempre un certo effetto

i diagrammi UML li ho usati spesso ma in progetti che riguardavano le basi di dati.
dipende da che cosa hai fatto nel progetto. parli di directory condivisa ma esattamente che hai fatto?

lo schema di Alvaro Vitali, a cui rinnovo i miei complimenti per l'interpretazione magistrale di Gian Burrasca, direi che è un buon punto di partenza

14-06-2005, 17:34	#1
Ghepardo Senior Member Iscritto dal: Jun 2002 Città: Roma Messaggi: 963	Come scrivere la documentazione? Ragazzi, volevo chiedervi dei piccoli consigli sul come dovrebbe essere organizzata/strutturata la documentazione di un software. Devo scrivere la documentazione di un progettino che sto facendo per un'esame all'università, ma nessuno ci ha mai spiegato come dovrebbe essere fatta. Spero voi possiate aiutarmi a capire. E' fatto in java quindi includerà le javadoc e ci siamo...ma il resto ? __________________ Asus P5K-E WiFi \| Intel Core 2 Due E8400 \| 4*1gb ram Kingston \| MSI GeForce 9800GTX 512Mb \| Tagan X-Eye II 600watt \| Win7 Business 64bit

14-06-2005, 20:43	#3
Ghepardo Senior Member Iscritto dal: Jun 2002 Città: Roma Messaggi: 963	progetto di reti di calcolatori. no, non abbiamo progettato il software con uml etc, il progetto riguarda una directory condivisa quindi cera poco da progettare con uml. cmq non deve essere proprio rigorosa... __________________ Asus P5K-E WiFi \| Intel Core 2 Due E8400 \| 4*1gb ram Kingston \| MSI GeForce 9800GTX 512Mb \| Tagan X-Eye II 600watt \| Win7 Business 64bit

14-06-2005, 18:14	#2
Alvaro Vitali Member Iscritto dal: Apr 2005 Messaggi: 224	Ma devi farla in modo rigoroso utilizzando un linguaggio di modellazione tipo UML e quindi hai progettato il software passando per tutti gli stadi Analisi, Design etc... o solo fornire una documentazione che descriva ciò che hai fatto? Mi sembra strano che chiedano una documentazione senza averti spiegato di cosa si tratta, di che esame si tratta?

14-06-2005, 22:27	#4
Alvaro Vitali Member Iscritto dal: Apr 2005 Messaggi: 224	Messa in questi termini credo che ti debba compilare una documentazione scritta che copra su per giù questi paragrafi: - Titolo - Obiettivi - Linguaggi e strumenti utilizzati - Istruzioni (tipo come avviare il server ed i client) - Protocollo utilizzato - Descrizione dettagliata -- Il Server -- Il Client Ioa llegherei un diagramma di flusso alla buona giusto per una schematizzazione della comunicazione client server dove mettere in parallello il flow della comunicazione. Tipo col server che fa socket->bind->listen-> ->accept->send->recive ed il client in parallelo che socket -> connect ecc...ecc.. ovviamente relativo alla tua applicazione... Che ne dici? Ciao!

15-06-2005, 10:45	#5
recoil Senior Member Iscritto dal: Jul 2002 Città: Milano Messaggi: 19149	di che l'hai scritta in latex, fa sempre un certo effetto i diagrammi UML li ho usati spesso ma in progetti che riguardavano le basi di dati. dipende da che cosa hai fatto nel progetto. parli di directory condivisa ma esattamente che hai fatto? lo schema di Alvaro Vitali, a cui rinnovo i miei complimenti per l'interpretazione magistrale di Gian Burrasca, direi che è un buon punto di partenza

Strumenti
Mostra una versione stampabile Invia questa pagina per email