Quanto è utile un diario di progetto o un diario? [chiuso]

Voglio sapere quanto sia difficile / utile tenere un diario di progetto o un diario. Sono preoccupato che tenere traccia di ciò che ho fatto consumerà troppo tempo ...

Sono preoccupato che tenere traccia di ciò che ho fatto consumerà troppo tempo ...

Mi preoccupo del contrario. Spesso scopro che il costo di non documentare qualcosa consuma ancora di più il mio tempo. Forse non succede oggi. Forse non domani, ma ad un certo punto la maggior parte delle cose che ho fatto sono tornate ad un certo punto, e in genere accade dopo che è trascorso abbastanza tempo perché il mio cervello lo consideri non importante.

Quindi documento le cose. Documento le decisioni che ho preso, gli accordi presi con i membri del team e, soprattutto, documento il mio codice, anche se implica solo l'uso di parole chiave per rendere più semplice il grep del progetto per una determinata funzione o riga di codice.

In alcuni casi, la documentazione ha risparmiato anche il tempo di altri. Sono questi i casi in cui gli X minuti trascorsi a documentare sono diventati un investimento in sé in cui gli X minuti investiti hanno dato un ritorno di Y * X minuti in risparmi di tempo!

Infine, in altri casi, ho scoperto che il lavoro di documentazione mi aiuta a ricordarlo. In alcuni casi, non ho mai più guardato la documentazione perché per me scrivere qualcosa è un catalizzatore per bruciarlo nella mia memoria.

Ognuno è diverso e dovrai trovare ciò che funziona per te. Per quanto mi riguarda, non posso dire di essermi pentito del tempo trascorso a documentare il mio lavoro, ma sono certo che mi sono pentito di non averlo fatto.

Anche se questa è una domanda piuttosto generica, penso che la risposta dipenda da quanto prezioso vedi l'autoriflessione.

Se la capacità di guardare indietro ai progressi è più preziosa per te che lavorare in qualsiasi momento ti prenderebbe per prendere appunti sui progressi, direi che è un'attività utile.

Penso che, in qualità di programmatore che lavora su un software, è bello avere un registro dei progressi e dei passaggi (simili alle note di controllo della versione) per tenere traccia delle modifiche apportate, dove sono state apportate e perché. Informazioni molto utili per la risoluzione dei problemi e per affrontare professionisti simili

Detto questo, non è difficile. È solo più utile se puoi farlo regolarmente e questo è aiutato da entrare in una routine per la maggior parte delle persone.

Provalo per 3 mesi. Scegli un formato semplice a cui puoi impegnarti e fallo. Se fornisce un vantaggio, continuate così, in caso contrario, rilasciarlo. Ogni settimana rivedi il formato delle voci e, se necessario, modificale.

Prova quanto segue:

All'inizio di ogni giorno scrivi

• Cosa hai intenzione di fare (paragrafo, foglio di calcolo, qualunque forma ti piaccia)
• Quali problemi ti aspetti di incontrare

Alla fine di ogni giornata scrivi

• Cosa hai fatto
• Quali ostacoli ti hanno ostacolato
• Quali tre cose hai imparato (tecnico, non tecnico, ecc.)

Ogni settimana, revisione

Probabilmente impiegano 5 minuti all'inizio e alla fine di ogni giorno. Successivamente puoi aggiungere cose che ti chiedi ogni settimana o cose che ti interessano. Non abbiate paura di cambiare formato ... carta una settimana, Wiki la prossima, Trello una terza. Ci vorrà un mese o più per sistemarsi in uno stile e trovare un ritmo.

È tempo ben speso. Conservo tutte le mie note in un programma chiamato Connected Text . Mi riferisco a problemi, riunioni, elementi del CYA, note di programmazione, note sulla lingua, frammenti di API, ecc. Uso anche Evernote per ritagliare le cose dal web e poi trasformarle in note. Molto di ciò che farai nella tua carriera verrà fuori di nuovo, quindi tenere appunti su come hai risolto questi problemi è una buona idea. Lo guardo come scaricando le minuzie per tenere a mente le cose importanti, sapendo che posso fare riferimento ai miei appunti. Dopotutto, è per questo che prendi appunti per cominciare.

Non è una perdita di tempo.

Uso una wiki personale da circa 7 anni, Wiki on a Stick o WoaS: http://stickwiki.sourceforge.net/

Ho creato una base di conoscenza per tutto il software che supporto, collegamenti a numerose risorse tecniche, note sulle riunioni del team: tutte queste sono conferenze telefoniche, ambiente di sviluppo documentale e obiettivi tecnici e professionali, elenchi di attività, ecc. Praticamente qualsiasi cosa scriverei su un blocco note o appiccicoso va in questo wiki. Utilizzando Firefox da http://portableapps.com , la mia intera wiki è autonoma, non richiede un server o l'installazione di alcun software sul computer client. Funziona anche su più piattaforme. L'unico problema che ho riscontrato è l'utilizzo di Chrome. Non salverà alcuna modifica. Firefox ha funzionato al meglio, quindi mi attengo.

Ci sono state diverse volte in cui un progetto è stato sottoposto a back-burning solo per farlo risorgere 9 mesi dopo. WoaS mi ha riportato indietro da dove avevo interrotto ed era produttivo senza cercare di ricordare cosa avevo fatto in precedenza o cosa era successo al blocco note che stavo usando allora.

Non mi sono mai pentito di aver dedicato del tempo a documentare il mio lavoro. Dopo un po 'di pratica, non ci vuole davvero molto tempo per prendere appunti. Se riesci a sviluppare un processo semplice ma efficace, avrai maggiori probabilità di farlo.

È un pezzo di letteratura.

Come nei tempi antichi, la conoscenza era meglio conservata quando scritta. "Tradizione orale" non è così efficace.

È un segno di maturità quando uno fa questo. Per rispondere alla tua domanda: è molto utile. Non saprai mai chi leggerà il tuo lavoro in futuro. È un buon contributo.

Fuori dalla mia testa, ecco alcuni dei motivi per cui è importante tenere un registro.

• Se desideri brevettare qualcosa che hai inventato, un diario di bordo diventa una prova molto vitale.
• Se lavori in un ambiente in cui esiste una cultura della colpa, vorrai notare cosa hai fatto, quando, cosa è stato detto, ecc., Semplicemente per coprire il tuo dorso.
• Se desideri tenere traccia di pensieri o idee che non hai tempo di esplorare immediatamente, un diario di bordo è un buon posto per annotare le cose per una successiva revisione.
• Se lavori su più progetti e il tuo foglio presenze richiede una contabilità relativamente dettagliata del tuo lavoro per tenere traccia dei costi del progetto o fatturare i clienti, il registro diventa un luogo per tenere traccia del tuo tempo.
• Note sulle riunioni del team, ordini del giorno e così via.
• Accordi, disaccordi, decisioni e soprattutto perché e come sono avvenute queste cose possono essere un vero salvavita quando le informazioni sono veramente necessarie.

Ogni volta che finisco di scrivere nell'ultima pagina di un diario di bordo, mi ritrovo a guardare indietro ai libri più vecchi di anni prima, solo per vedere fino a che punto sono arrivate le mie conoscenze, come il mio modo di pensare è cambiato e può essere sorprendente quello che impara dal tuo passato lavorativo, in particolare se stai pensando di cambiare lavoro e vuoi riempire il tuo CV con molti progetti e risultati davvero interessanti.

Molto dipende dalle dimensioni del progetto e dagli obiettivi del progetto. In un piccolo progetto puoi mettere le cose in Excel. Ricorda che la rielaborazione richiede più tempo rispetto a fare qualcosa di giusto la prima volta, quindi vale la pena pianificare un po 'per risparmiare tempo in seguito.

Cose che dovresti tracciare negli elenchi:

• Impegni esterni, in particolare date.

• Scope - Almeno ad un livello elevato. A seconda della situazione, questo diventa più dettagliato.

• Dipendenze: cosa ti serve dagli altri.

• Problemi, rischi e cose da fare

• Qual è il tuo tempo trascorso (il rigore dipende se questo è per conoscenza di sé o fatturazione esterna)