Lo sviluppo iterativo della documentazione è possibile e fornisce una documentazione efficace?

11

Ho un progetto per l'università che non inizierò immediatamente, ma ho pensato per un periodo di tempo abbastanza lungo. Capisco che lo sviluppo di un progetto universitario non è come l'industria (attualmente sono uno stagista) quindi la situazione che sottolineerò al momento probabilmente sembrerà un po 'ridicola agli sviluppatori di software reali. ^^ '

Il progetto stesso richiede che documentiamo molto del nostro lavoro. Quindi, oltre alla consegna del codice, che conta per alcuni dei marchi, dobbiamo consegnare documenti tra cui:

  • Un documento di analisi dei requisiti
  • Un piano di progetto
  • Un elenco pianificato di casi d'uso, modelli oggetto e modelli dinamici e test di accettazione
  • Documentazione del processo di test e quanto successo hanno avuto i test
  • Altre discussioni e analisi sull'uso del tempo, ecc.

Questi deliverable devono essere consegnati nel modo seguente:

  • RAD prima
  • Seguito da piano di progetto, casi d'uso, modelli e test (circa 3 settimane dopo)
  • Infine, la documentazione del programma attuale, il processo di test, ecc. + la stessa programmazione vera e propria (circa 5 settimane dopo)

Quindi, da quello che ho capito, questo è davvero orientato verso un approccio in stile Waterfall al progetto. L'unico problema (secondo me) è che si tratta di un progetto universitario, e gli studenti hanno già abbastanza pressione come lo è con il tentativo di sviluppare progetti alla fine del semestre durante la settimana del progetto. Non voglio davvero programmare / sviluppare / testare tutto alla fine del semestre, quando mi farò prendere dal panico con tutte le altre valutazioni che devo affrontare.

Mi piacerebbe almeno provare e fare una sorta di ciclo di sviluppo iterativo che significa che possiamo iniziare presto la programmazione / prototipazione, avere un ciclo di sviluppo continuo che non è focalizzato a fare tutto all'ultimo minuto e non averlo molta pressione alla fine del semestre per finire questo progetto. E ora arriva la mia domanda reale:

  • Posso in qualche modo conciliare dover consegnare tutta la documentazione con un ciclo di sviluppo veloce, iterativo / di prototipazione?
  • Esistono strategie per generare documentazione in modo iterativo?
  • Sono del tutto irragionevole chiedermelo e mi aspetto che sia in grado di farlo all'Università?

Inoltre, capisco che questa domanda sia estremamente localizzata, quindi vorrei porre le stesse domande che ho posto in precedenza in termini di industria e se molti problemi di questo tipo che i processi agili affrontano o meno sono diversi per ogni squadra o azienda.

Ad ogni modo, mi dispiace per quanto è lungo, e se hai finito di leggere fino in fondo, grazie! Se potessi avere il tempo di rispondere, sarei molto grato! Grazie!

    
posta blahman 16.01.2012 - 08:22
fonte

1 risposta

5

La preoccupazione principale (ho un problema simile con il mio lavoro) è che se "Il Processo" richiede di consegnare determinati artefatti in determinati momenti, e nessuno è autorizzato a sfidare l'onnipotente "Il Processo", allora se tu prova, ti perderai! Non è solo una semplice questione di esso è un modo migliore (che è lo sviluppo di documenti iterativo).

Quindi quello che devi fare è lavorare all'interno del processo, ma trovare il modo di lavorare come preferisci. Ad esempio, il tuo processo consente la modifica del documento una volta inviato? In caso contrario, non è possibile alcuno sviluppo iterativo. Se è così, allora devi pensare al costo della consegna (in termini di tempo, credibilità, ecc.) E gestire quel costo. Se, ad esempio, è una copia di un file e niente di più, allora vai a prenderlo. Se (come me) è una revisione tra pari, una revisione, impatta dozzine di persone e costa migliaia di dollari, quindi pensa attentamente e assicurati che il nuovo documento dia davvero un valore aggiunto.

Un modo comune di lavorare è un elemento essenziale, un documento minimo che soddisfa le esigenze di "The Process" all'inizio, seguito in seguito da un aggiornamento finale "come costruito" che non riflette solo la realtà, ma ha i dettagli dove necessario ed è breve dove il codice parla da solo.

    
risposta data 16.01.2012 - 10:17
fonte

Leggi altre domande sui tag