Supporto / documentazione di manutenzione per il team di sviluppo

3

Lavoro nel reparto Sviluppo (circa 40 sviluppatori) per una grande azienda di commercio elettronico. Siamo cresciuti rapidamente ma non ci siamo evoluti molto bene nel documentare il nostro lavoro. Lavoriamo con una metodologia Agile / Scrum-like con il nostro sviluppo e test, ma la documentazione sembra essere trascurata.

Dobbiamo essere in grado di creare documentazione che possa aiutare uno sviluppatore che non ha lavorato al nostro progetto prima o era nuovo per la società. Dobbiamo anche creare ulteriori informazioni di alto livello per il nostro dipartimento di supporto per spiegare eventuali impostazioni aggiuntive di configurazione e correzioni di problemi noti che potrebbero verificarsi, se presenti.

Attualmente lo inseriamo in una wiki mal composta, basata su un vecchio sito Sharepoint / TFS.

Qualcuno può suggerire qualche link o consiglio ideale per migliorare lo standard della documentazione? Cosa funziona in altre aziende?

Qualcuno ha avuto problemi nello sviluppo della documentazione come parte di un processo agile?

Grazie mille,

Ben

    
posta benwebdev 18.01.2011 - 12:49
fonte

2 risposte

2

Includi documentazione nel tuo DoD, Definizione di fatto . Funziona perfettamente con Scrum .

Spiegazione qui: Manuali - In che modo?

    
risposta data 18.01.2011 - 12:51
fonte
0

Sono d'accordo con Pierre 303, se lo rendi un chiaro risultato da non perdere:).

Trovo che le cattive tecnologie ostacolino la documentazione, e Sharepoint Wiki non è per niente eccezionale :(. consiglierei comunque un wiki o qualche tipo di approccio collaborativo, vuoi veramente fare documentazione di tutti responsabilità condivisa.

Al momento utilizzo una combinazione di Mediawiki (documenti guidati da team / community) e docbook (documentazione formale da stampare / rilasciare).

Suggerisco l'abbinamento per ottenere la documentazione, crea quel lavoro di squadra che è vitale per completare un'attività che tende a essere vista come qualcosa di impopolare.

    
risposta data 18.01.2011 - 12:57
fonte

Leggi altre domande sui tag