¿Debería cada programador llevar un diario de "Lecciones aprendidas"? [cerrado]

12

Cada vez que termino un proyecto, siempre hay algo que he aprendido (de lo contrario, no me parece muy motivador). Pero no puedo recordar todo, y mucho más tarde puedo tropezar con el mismo problema que encontré en un proyecto anterior, pero ya no sé cómo lo resolví (o al menos qué intentos hice).

Entonces, ¿sería una buena idea escribir esto en un diario de algún tipo? Sé que escribir cosas se siente como escribir documentación (lo que no todos disfrutan hacer), y espero que nuestra memoria nos sirva cuando sea necesario. Pero tenerlo documentado, podría ser compartido con otros programadores y aprender qué lecciones aprendieron.

¿Entonces, qué piensas?

gablin
fuente

Respuestas:

9

Blog técnico sería una gran opción aquí para obtener la experiencia consolidada. Incluso esto ayudará a otros en todo el mundo a aprender de tus errores :)

Gopi
fuente
Mantengo un blog sobre las lecciones aprendidas (ve aquí -> teadrinkinggeek.wordpress.com ), y te ayuda a (1) premiarte por lo que has aprendido (2) a revisar lo que has aprendido durante un período de tiempo.
TeaDrinkingGeek
2
@TeaDrinkingGeek: puede incrustar enlaces en los comentarios utilizando la [visible text](http://url.to/page)sintaxis;) Me gusta esto
Konerak
6

Parece una buena idea revisar lo que se hizo al final del proyecto y los problemas encontrados, y ver qué causó esos problemas y cómo evitarlos. Escribirlo en un diario también es una buena idea, ya que hace que sea más fácil recordarlo y evitar los mismos problemas nuevamente más tarde.

Compartir, por otro lado, debe hacerse con precaución. Por supuesto, es útil para otros desarrolladores y gerentes de proyectos, pero si trabaja con clientes y esos clientes pueden leer sobre los problemas que tuvo en el pasado, estarán menos inclinados a comenzar / continuar trabajando con usted, porque:

  • Sentirán que te encuentras con más problemas con los proyectos que otras personas (incluso si está mal),
  • No quieren que publiques información sobre los eventuales problemas encontrados en sus proyectos.
Arseni Mourzenko
fuente
Creo que esto normalmente se llama análisis post mortem. Se lleva a cabo (un caso) cuando finaliza el período de soporte y el producto está básicamente muerto y ya no es compatible.
Bjarke Freund-Hansen
3

Tengo un diario de Elder Scrollsy donde escribo cosas cada vez que aprendo algo nuevo. Como puedes imaginar, se ha vuelto bastante grande y lleno de información.

De hecho, he estado pensando en crear un software que solo me permita escribir notas y etiquetar las notas de forma similar a lo que hacen los sitios de SE con preguntas.

Sería capaz de:

  • Buscar publicaciones por fecha.
  • Buscar publicaciones por etiquetas.
  • Buscar publicaciones por dificultad.

Esto sería realmente útil para mí.


fuente
¿BlogSpot ya no hace eso?
Vinoth Kumar CM
Supongo que si quieres algo tan grande, puedes usar eso también.
3

Lo intenté una vez, con un diario de las cosas que había hecho, reflexionando sobre lo que podría haber ido mejor y lo que debería intentar diferente la próxima vez. Esto no era algo técnico: se trataba de interacciones con otras personas del equipo, decisiones tomadas en reuniones, etc. (sí, ¡esta compañía tenía suficientes reuniones que tenía algo que escribir todos los días!).

Finalmente descubrí que el diario era memoria de solo escritura: tal vez la experiencia de escribirlo ayudó a organizar mis pensamientos o evaluar lo que había hecho, pero después de unas seis semanas descubrí que nunca había regresado y revisé lo que había escrito. escrito así que dejé de guardarlo.

En cuanto a las notas técnicas, realmente no las guardo a menos que tenga que presentarlas a una conferencia o un cliente. De lo contrario, un conjunto de marcadores en Pinboard.in es suficiente para mí.


fuente
2

Absolutamente, uno debe llevar un diario de las lecciones aprendidas y aprendidas. El primero consolida el tipo de aprendizaje más costoso, que se obtiene a través de la experiencia directa. Este último requiere / estimula el aprendizaje proactivo, que es un requisito para no chupar.

El registro en diario es una de las herramientas de autodesarrollo más antiguas que se conocen, y provoca la (auto) reflexión, que es un método aún más antiguo. Uno necesita ambos.

limist
fuente
1

Absolutamente. Historia verdadera: Poco después de leer esta pregunta, me topé con un problema que sabía que había resuelto antes (un problema de configuración, si es importante). Hojeé mi cuaderno "Lecciones aprendidas" (edición en papel y bolígrafo), y ahí estaba la solución: copiar el archivo a a la ubicación b.

Este cuaderno me ayuda de dos maneras: primero, proporcionando un lugar para encontrar respuestas a las preguntas previamente formuladas y los problemas resueltos, y segundo, reforzando el conocimiento al escribirlo (algo así como explicárselo a otra persona).

Por supuesto, pierdo dicho cuaderno de vez en cuando ...

PSU
fuente
0

Para eso es un sistema de gestión de proyectos / problemas, como TRAC, Jira o lo que sea que tenga. En el trabajo pongo comentarios detallados, procedimientos, dependencias en nuestro TRAC y Jira y para que cuando enfrentemos un problema visto anteriormente, una simple búsqueda nos dé la respuesta.

chiurox
fuente