Linee guida riassunte per altri requisiti

Elaborati e sito web del progetto
...

Gli elaborati sui requisiti devono essere certamente pubblicati sul sito web del progetto. Poiché questa è una documentazione di carattere statico e orientato a una stesura a mo' di libro, gli esempi e i casi d'uso mostrati avranno la stessa natura. Tuttavia, questi dovrebbero essere creati digitalmente e caricati/mantenuti online sul sito web del progetto. Oltre ad essere statici potrebbero essere anche dotati di collegamenti ipertestuali, per esempio potrebbero essere memorizzati in un Wiki sul Web.

Scrivere elenco delle caratteristiche
...

Nel documento di Visione è utile essere concisi, come in ogni documento.

Quante caratteristiche di sistema deve contenere il documento di Visione?
...

É opportuno che ne contenga meno di 10 caratteristiche, poiché un numero superiore può non essere afferrato rapidamente. Nel caso, si considerino raggruppamenti e astrazioni delle caratteristiche.

Documento Visione e duplicazione di altri requisiti
...

Nella Visione, le caratteristiche di sistema riassumono brevemente requisiti funzionali che sono spesso dettagliati nei casi d'uso. Allo stesso modo, la Visione può riassumere altri requisiti (per esempio affidabilità e usabilità) che sono dettagliati nelle Specifiche supplementari. Bisogna però cercare di evitare le ripetizioni, nella Visione si rimandi il lettore agli altri requisiti nelle Specifiche Supplementari.

Si deve scrivere prima il documento di Visione o i Casi d'Uso?
...

Non ha senso essere rigidi sulla questione dell'ordine. Tuttavia una sequenza consigliata è:

  1. Scrivere una prima breve bozza della Visione.
  2. Identificare gli obiettivi degli utenti e il nome dei casi d'suo che li sostengono.
  3. Scrivere alcuni casi d'uso nel dettaglio e iniziare le Specifiche Supplementari.
  4. Raffinare il documento di Visione, riepilogando le informazioni degli altri.

Iniziare presto a scrivere il Glossario
...

Diventerà presto un raccoglitore di informazioni dettagliate relativi a elementi a grana fine.

Glossario e termini composti
...

Il Glossario non è destinato a descrivere solo termini atomici (si intende in questo caso, termini composti da un unico attributo, ovvero la descrizione del significato), ma anche elementi composti e pseudonimi usati per descrivere gruppi di dati.
Ad esempio:

  • "prezzo di un prodotto" è un elemento atomico, il suo unico attributo è descrivere il costo di un prodotto.
  • "vendita" è un elemento composto dalla sua descrizione ovvero la cessione di un prodotto in cambio di un costo, ma ha anche una data in cui si svolge e un orario.