Di recente, abbiamo appena terminato la prima fase del nostro progetto.
Abbiamo usato agile con sprint quindicinali. E mentre l'applicazione è andata a buon fine, ora stiamo girando gli occhi su alcune delle attività di manutenzione.
Un compito di manutenzione è che tutta la nostra documentazione appare sotto forma di specifiche. Queste specifiche descrivono 1 o più storie e generalmente sono un insieme di lavoro che alcuni sviluppatori potrebbero rovesciare in una settimana.
Per lo sviluppo, funziona davvero bene - ogni due settimane gli sviluppatori ricevono una specifica ed è un bel pezzo di lavoro che possono semplicemente fare.
Da un punto di vista della documentazione, questo è diventato un casino. Il problema con le specifiche di scrittura che sono focalizzate sulla fornitura di requisiti just-in-time agli sviluppatori è che non abbiamo posto molta enfasi sul quadro generale.
Le specifiche provengono da tutte le angolazioni diverse: potrebbe descrivere una funzione standard, potrebbe descrivere parti di un flusso di lavoro, potrebbe descrivere un particolare schermo ...
E ora disponiamo di regole aziendali relative alla nostra applicazione distribuite su 120 documenti. Cercare qualsiasi documento per una particolare regola o funzione aziendale in particolare è piuttosto difficile perché non si sa quale documento abbia questa informazione, e fare una richiesta di modifica è altrettanto difficile, perché ancora una volta, non siamo sicuri su quale specifica fare la modifica .
Quindi abbiamo forse un paio di settimane di pausa prima che si ritorni a individuare le funzionalità per la fase successiva, ma in questo momento, mi piacerebbe rivedere i nostri processi. Penso che il modo in cui abbiamo lavorato finora in termini di fornitura di specifiche quindicinali funzioni bene.
Ma abbiamo anche bisogno di un modo per gestire la nostra documentazione in modo che le nostre regole aziendali per una data funzione / flusso di lavoro siano facili da individuare / modificare.
Ho due idee.
Uno è quello di compilare tutte le nostre specifiche in una serie di specifiche principali suddivise in alcune vaste aree funzionali. Le specifiche descrivono lo sprint, le specifiche principali descrivono il sistema. L'unico problema che riesco a vedere è 1) Le nostre 120 specifiche non sono tutte ben definite in ampie aree funzionali. Alcuni richiederanno la disgregazione, la fusione ecc. Che richiederà molto tempo. 2) Scriverò specifiche e aggiorneremo le specifiche principali in ogni nuovo sprint. Sembra il doppio del lavoro, e poi gli sviluppatori guardano le specifiche o le specifiche principali?
Il mio altro suggerimento è di ammettere che la nostra documentazione è troppo confusa e gestire quel casino in futuro. Quindi analizziamo ogni specifica, assegniamo come parole chiave ad essa, e poi quando vogliamo cercare una funzione, cerchiamo quella parola chiave. Problemi che riesco a vedere 1) Ancora il problema delle regole aziendali sparse ovunque, le parole chiave rendono più facile trovarlo.
in ogni caso, se qualcuno ha idee decenti o qualsiasi esperienza da condividere sul modo migliore di gestire la documentazione, lo apprezzerebbe molto.