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

I'm worried that keeping track of what I did will eat up too much time...

Mi preoccupo del contrario. Spesso trovo che il costo di non che documenta qualcosa mi divora ancora di più del mio tempo. Forse non succede oggi. Forse non domani, ma a un certo punto la maggior parte delle cose che ho fatto sono tornate a un certo punto, e in genere accade dopo che è trascorso abbastanza tempo perché il mio cervello la 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 riguarda solo l'utilizzo di parole chiave per rendere più semplice il progetto per una determinata funzione o linea di codice.

In alcuni casi, la documentazione ha salvato anche il tempo degli altri. Sono questi i casi in cui i minuti X dedicati alla documentazione sono diventati un investimento in sé stesso in cui gli X minuti investiti hanno dato un ritorno di Y * X minuti in risparmi di tempo!

Infine, in altri casi, ho trovato 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.

Tutti sono diversi 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 di sicuro mi sono pentito delle volte che non ho.

Anche se questa è una domanda piuttosto generica, penso che la risposta dipenda da quanto tu possa vedere di per sé l'auto-riflessione.

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

Penso che, come programmatore che lavora su un software, è bello avere qualche registro dei progressi e dei passi fatti (simile alle note di controllo della versione) per tenere traccia delle modifiche apportate, dove le hai realizzate e perché . Informazioni molto utili quando si risolvono i problemi e quando si affronta un professionista simile

Detto questo, non è difficile. È ancora più utile se riesci a farlo regolarmente e ciò è agevolato dall'avere una routine per la maggior parte delle persone.

Provalo per 3 mesi. Scegli un formato semplice a cui puoi impegnarti e farlo. Se fornisce vantaggi, continua così, se no, rilasciala. Ogni settimana rivedere il formato delle voci e regolarle se necessario.

Prova quanto segue:

All'inizio di ogni giorno scrivi

• Che cosa intendi fare (paragrafo, foglio di lavoro, qualsiasi forma ti piaccia)
• Quali problemi ti aspetti di incontrare

Alla fine di ogni giornata scrivi

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

Ogni settimana, esamina

Probabilmente occorrono 5 minuti all'inizio e alla fine di ogni giorno. Puoi in un secondo momento aggiungere cose che ti chiedi ogni settimana o cose che ti interessano. Non temere di cambiare formato ... carta una settimana, Wiki alla prossima, Trello alla terza. Ci vorrà un mese o più per stabilirsi in uno stile e trovare un solco.

È tempo ben speso. Conservo tutte le mie note in un programma chiamato Testo connesso . Mi riferisco a problemi, riunioni, articoli CYA, note di programmazione, note di lingua, frammenti API, ecc. Uso anche Evernote per ritagliare le cose dal web e quindi trasformarli in note. Molto di quello che farai nella tua carriera tornerà di nuovo, quindi tenere una nota su come hai risolto quei problemi è una buona idea. Lo guardo come se stessi caricando le minuzie per mantenere le cose importanti nella mia mente, sapendo che posso riferirmi ai miei appunti. Dopotutto, è il motivo per cui prendi appunti per cominciare.

Non è una perdita di tempo.

Uso un wiki personale da circa 7 anni, Wiki on a Stick o WoaS: link

Ho creato una base di conoscenza per tutto il software che supporto, collegamenti a numerose risorse tecniche, note di riunione del team - tutte queste sono conferenze telefoniche, documentazione dell'ambiente di sviluppo, obiettivi tecnici e professionali, liste di cose da fare, ecc. Praticamente tutto ciò che faccio 'scrivere su un blocco note o sticky va in questo wiki. Usando Firefox dal link , la mia intera wiki è autonoma, non richiede un server o installa alcun software sul computer client. Funziona anche su piattaforme diverse. L'unico problema che ho riscontrato è l'utilizzo di Chrome. Non salverà alcuna modifica. Firefox ha funzionato al meglio, quindi me lo tengo.

Ci sono state diverse volte che un progetto è stato retro-bruciato solo per farlo risorgere 9 mesi dopo. WoaS mi ha riportato da dove avevo lasciato ed è stato produttivo senza cercare di ricordare quello che avevo fatto in precedenza o quello che è successo al blocco note che stavo usando in quel momento.

Non mi sono mai pentito di aver trovato il tempo per documentare il mio lavoro. Dopo un po 'di pratica, non ci vuole molto tempo per prendere appunti. Se riesci a sviluppare un processo semplice ma affettivo, sarai più propenso a farlo.

È un pezzo di letteratura.

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

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

In cima alla mia testa, ecco alcuni motivi per cui è importante tenere un registro.

• Se desideri brevettare qualcosa che hai inventato, allora un diario di bordo diventa una prova molto vitale.
• Se lavori in un ambiente in cui c'è una cultura di colpa, vorrai annotare ciò che hai fatto, quando, cosa è stato detto, ecc., semplicemente per coprire il tuo didietro.
• Se desideri tenere traccia di pensieri o idee che non hai il tempo di esplorare immediatamente, allora un diario di bordo è un buon posto dove annotare le cose per una revisione successiva.
• Se lavori su più progetti e il tuo time sheet richiede una contabilità relativamente dettagliata del tuo lavoro per tenere traccia dei costi del progetto o fatturare i clienti, il registro diventa un luogo in cui tenere traccia del tuo tempo.
• Note sulla riunione del team, ordini del giorno e così via.
• Accordi, disaccordi, decisioni e soprattutto perché e come sono avvenute queste cose può essere un vero risparmiatore di vita quando le informazioni sono davvero necessarie.

Ogni volta che finisco di scrivere nell'ultima pagina di un diario di bordo, mi ritroverò a guardare indietro ai libri più vecchi di anni prima, solo per vedere quanto è arrivata la mia conoscenza, come è cambiato il mio modo di pensare, e può essere incredibile quello che impari dal tuo passato di lavoro, 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 rilavorazione richiede più tempo del fare qualcosa di giusto la prima volta, quindi vale la pena pianificare un po 'di tempo per risparmiare tempo.

Cose da tenere traccia negli elenchi:

• Impegni esterni, in particolare date.

• Ambito di applicazione - Almeno ad alto livello. A seconda della situazione questo diventa più dettagliato.

• Dipendenze: ciò di cui hai bisogno dagli altri.

• Problemi, rischi e cose da fare

• A cosa dedichi il tuo tempo (il rigore dipende se questo è per la conoscenza di te stesso o per la fatturazione esterna)