¿Qué tan útil es un registro o diario de proyecto? [cerrado]

Quiero saber qué tan difícil / útil es mantener un registro o diario del proyecto. Me preocupa que llevar un registro de lo que hice consumirá demasiado tiempo ...

Me preocupa que llevar un registro de lo que hice consumirá demasiado tiempo ...

Me preocupa lo contrario. A menudo encuentro que el costo de no documentar algo consume aún más de mi tiempo. Tal vez no suceda hoy. Tal vez no mañana, pero en algún momento la mayoría de las cosas que he hecho han vuelto a surgir en algún momento, y generalmente sucede después de que ha pasado suficiente tiempo para que mi cerebro lo considere sin importancia.

Por lo tanto, documento cosas. Documento las decisiones que he tomado, los acuerdos realizados con los miembros del equipo y, lo que es más importante, documento mi código, incluso si solo implica el uso de palabras clave para facilitar el trabajo del proyecto para una determinada función o línea de código.

En algunos casos, la documentación también ha ahorrado tiempo a otros. En estos casos, los X minutos dedicados a la documentación se convirtieron en una inversión en sí mismos, donde los X minutos invertidos dieron un retorno de Y * X minutos en ahorro de tiempo.

Por último, en otros casos, descubrí que documentar el trabajo me ayuda a recordarlo. En algunos casos, nunca volví a mirar la documentación porque, para mí, escribir algo es un catalizador para grabarlo en mi memoria.

Todos somos diferentes y necesitarás encontrar lo que funcione para ti. En cuanto a mí, no puedo decir que haya lamentado el tiempo dedicado a documentar mi trabajo, pero estoy seguro de que he lamentado las veces que no.

Aunque esta es una pregunta bastante general, creo que la respuesta se reduce a lo valioso que ves la autorreflexión.

Si la capacidad de mirar hacia atrás en el progreso es más valiosa para usted que trabajar a través del tiempo que le tome tomar notas sobre el progreso, diría que es una actividad que vale la pena.

Creo que, como programador que trabaja en una pieza de software, es bueno tener un registro de progreso y pasos tomados (similar a las notas de control de versiones) para realizar un seguimiento de los cambios que realizó, dónde los realizó y por qué. Información muy útil al solucionar problemas y al abordar profesionales similares

Dicho esto, no es difícil. Es más útil si puede hacerlo con regularidad, y eso se ayuda con la rutina para la mayoría de las personas.

Pruébalo por 3 meses. Elija un formato simple con el que pueda comprometerse y hágalo. Si proporciona beneficios, entonces manténgalo, si no, déjelo. Cada semana revise el formato de sus entradas y ajústelas si es necesario.

Intenta lo siguiente:

Al comienzo de cada día escriba

• Lo que vas a hacer (párrafo, hoja de cálculo, cualquier forma que quieras)
• ¿Qué problemas esperas encontrar?

Al final de cada día escriba

• Que hiciste
• ¿Qué obstáculos se interponen en tu camino?
• Las tres cosas que aprendiste (técnicas, no técnicas, etc.)

Cada semana, repase

Probablemente tome 5 minutos al comienzo y al final de cada día. Luego puede agregar cosas que se pregunta cada semana o cosas que le interesan. No tenga miedo de cambiar los formatos ... papel una semana, Wiki la siguiente, Trello un tercero. Tomará un mes o más para adaptarse a un estilo y encontrar un ritmo.

Es tiempo bien empleado. Mantengo todas mis notas en un programa llamado Texto conectado . Me refiero a problemas, reuniones, elementos de CYA, notas de programación, notas de idioma, fragmentos de API, etc. También uso Evernote para recortar cosas de la web y luego convertirlas en notas. Mucho de lo que harás en tu carrera volverá a surgir, por lo que una buena idea es tomar notas sobre cómo resolviste esos problemas. Miro esto como cargar las minucias para mantener las cosas importantes en mi mente, sabiendo que puedo consultar mis notas. Después de todo, es por eso que tomas notas para empezar.

No es una pérdida de tiempo.

He estado usando un wiki personal durante aproximadamente 7 años, Wiki on a Stick o WoaS: http://stickwiki.sourceforge.net/

Creé una base de conocimiento para todo el software que soporto, enlaces a numerosos recursos técnicos, notas de reuniones de equipo: todas ellas son conferencias telefónicas, documentar el entorno de desarrollo y objetivos técnicos y profesionales, listas de tareas pendientes, etc. Prácticamente cualquier cosa que escribiría en un bloc de notas o pegajoso va en este wiki. Utilizando Firefox de http://portableapps.com , mi wiki completo es autónomo, no requiere un servidor o la instalación de ningún software en la computadora cliente. Funciona multiplataforma también. El único problema que he tenido es usar Chrome. No guardará ningún cambio. Firefox ha funcionado mejor, así que me quedo con él.

Ha habido varias veces que un proyecto fue retrasado solo para resucitarlo 9 meses después. WoaS me trajo de vuelta donde lo dejé y fue productivo sin tratar de recordar lo que había hecho anteriormente o lo que sucedió con el bloc de notas que estaba usando en ese momento.

Nunca me he arrepentido de tomarme el tiempo para documentar mi trabajo. Después de un poco de práctica, realmente no toma mucho tiempo guardar notas. Si puede desarrollar un proceso simple pero afectivo, será más probable que lo haga.

Es una pieza de literatura.

Al igual que en la antigüedad, el conocimiento se conservaba mejor cuando se escribía. La "tradición oral" no es tan efectiva.

Es una señal de madurez cuando uno hace esto. Para responder a su pregunta: es muy útil. Nunca sabrás quién leerá tu trabajo en el futuro. Es un buen aporte.

Fuera de mi cabeza, aquí hay algunas razones por las cuales es importante mantener un registro.

• Si desea patentar algo que ha inventado, entonces un libro de registro se convierte en una evidencia muy importante.
• Si trabaja en un entorno donde hay una cultura de culpa, tendrá que anotar lo que hizo, cuándo, qué se dijo, etc., simplemente para cubrir su propio trasero.
• Si desea realizar un seguimiento de los pensamientos o ideas que no tiene tiempo para explorar de inmediato, entonces un libro de registro es un buen lugar para anotar cosas para su posterior revisión.
• Si trabaja en múltiples proyectos y su hoja de tiempo requiere una contabilidad relativamente detallada de su trabajo para rastrear los costos del proyecto o facturar a los clientes, el libro de registro se convierte en un lugar para rastrear su tiempo.
• Notas de la reunión del equipo, agendas, etc.
• Los acuerdos, desacuerdos, decisiones y especialmente por qué y cómo ocurrieron estas cosas pueden ser un verdadero salvavidas cuando la información es realmente necesaria.

Cada vez que termine de escribir en la última página de un libro de registro, me encontraré mirando libros antiguos de años anteriores, solo para ver cuán lejos ha llegado mi conocimiento, cómo ha cambiado mi pensamiento, y puede ser sorprendente lo que usted aprenda de su propio pasado laboral, especialmente si está pensando en cambiar de trabajo y desea completar su CV con muchos proyectos y logros realmente interesantes.

Mucho depende del tamaño del proyecto y los objetivos del proyecto. En un proyecto pequeño puedes poner cosas en Excel. Recuerde que volver a trabajar lleva más tiempo que hacer algo bien la primera vez, por lo que vale la pena planificar un poco para ahorrar tiempo más tarde.

Cosas que debe rastrear en las listas:

• Compromisos externos, especialmente fechas.

• Alcance: al menos a un nivel alto. Dependiendo de la situación, esto se vuelve más detallado.

• Dependencias: lo que necesita de los demás.

• Problemas, riesgos y tareas pendientes

• En qué gasta su tiempo (el rigor depende de si esto es para el autoconocimiento o la facturación externa)