Struttura della documentazione nella documentazione del ciclo di vita dello sviluppo del software

0

Nella creazione di documentazione per il ciclo di vita di un progetto, è meglio avere tutte le decisioni e le scelte (incluse le risorse come le immagini) inserite nello stesso documento, o è meglio modularle? Cioè Per avere ogni decisione e processo nel proprio documento con collegamenti ai documenti precedenti e seguenti?

Esempio:

Structure A
├── File 1
│    ├── Decision 1
│    ├── Choices 1
│    ├── Decision 2
│    └── Choices 2
|__

vs

Structure B
├── File 1
│    ├── Decisions 1
│    └── Choices 1
├── File 2
│    ├── Decisions 2
│    └── Choices 2
└── 

Nota: vengono utilizzate molte immagini e schermate. I documenti sono scritti in MS Word.

Non ho completato la documentazione, tuttavia sembra che il file si stia ingrandendo e non so chi lo manterrà in futuro. Metterebbe forse anche una sorta di file di navigazione o README nella directory principale di Structure B che gli conferisca una migliore struttura strutturale rispetto alla Structure A?

    
posta TritonJak 22.12.2016 - 00:31
fonte

0 risposte

Leggi altre domande sui tag