Todo programador deve manter um diário “Lessons Learned”? [fechadas]

Toda vez que termino um projeto, sempre há algo que aprendi (caso contrário, não acho muito motivador). Mas não consigo me lembrar de tudo e, muito mais tarde, posso me deparar com o mesmo problema que encontrei em um projeto anterior, mas não como mais o resolvi (ou pelo menos quais as tentativas que fiz).

Então, seria uma boa idéia escrever isso em algum tipo de diário? Sei que escrever coisas parece escrever documentação (que nem todo mundo gosta de fazer), e espero que nossa memória nos sirva quando necessário. Mas, documentado, ele poderia ser compartilhado com outros programadores e aprender as lições que eles aprenderam.

Então, o que você acha?

O Blog técnico seria uma ótima opção aqui para obter a experiência consolidada. Mesmo isso ajudará outras pessoas em todo o mundo a aprender com seus erros :)

Parece uma boa ideia revisar o que foi feito no final do projeto e os problemas encontrados, e ver o que causou esses problemas e como evitá-los. Escrevê-lo em um diário também é uma boa idéia, pois facilita a recuperação e evita os mesmos problemas mais tarde.

Compartilhar, por outro lado, deve ser feito com cautela. Obviamente, é útil para outros desenvolvedores e gerentes de projeto, mas se você trabalha com clientes e esses clientes podem ler sobre os problemas que você teve no passado, eles estarão menos inclinados a começar / continuar trabalhando com você, porque:

• Eles sentirão que você encontra mais problemas com projetos do que outras pessoas (mesmo que esteja errado),
• Eles não querem que você publique informações sobre os eventuais problemas encontrados em seus projetos.

Tenho um diário do Elder Scrollsy onde escrevo as coisas toda vez que aprendo algo novo. Como você pode imaginar, ficou muito grande e cheio de informações.

Na verdade, estive pensando em criar um software que me permita escrever notas e marcar as notas de maneira semelhante ao que os sites SE fazem com perguntas.

Eu seria capaz de:

• Pesquise postagens por data.
• Pesquise postagens por tags.
• Pesquise posts por dificuldade.

Isso seria realmente útil para mim.

Eu tentei isso uma vez, com um diário de coisas que havia feito, refletindo sobre o que poderia ter sido melhor e o que eu deveria tentar diferente da próxima vez. Isso não era coisa de técnico - tratava-se de interações com outras pessoas da equipe, decisões tomadas em reuniões e assim por diante (sim, essa empresa tinha reuniões suficientes para que eu tivesse algo para escrever todos os dias!).

Acabei descobrindo que o diário era apenas uma memória para gravação: talvez a experiência de redigi-lo tenha ajudado a organizar meus pensamentos ou avaliar o que eu havia feito, mas depois de seis semanas descobri que nunca havia voltado e revisado o que havia feito. escrito, então eu parei de mantê-lo.

No que diz respeito às notas técnicas, eu realmente não as guardo, a menos que precise apresentar a uma conferência ou a um cliente. Caso contrário, um conjunto de indicadores no Pinboard.in é suficiente para mim.

Absolutamente, deve-se manter um diário de lições aprendidas e lições aprendidas. O primeiro consolida o tipo de aprendizado mais caro, obtido através da experiência direta. O último requer / estimula o aprendizado proativo, necessário para não ser ruim.

O registro no diário é uma das mais antigas ferramentas de autodesenvolvimento conhecidas e solicita (auto) reflexão, que é um método ainda mais antigo. Um precisa de ambos.

Absolutamente. História verdadeira: Pouco depois de ler esta pergunta, encontrei um problema que sabia que havia resolvido antes (um problema de configuração, se for o caso). Percorri o caderno "Lições Aprendidas" (edição em papel e caneta) e havia a solução: copiar o arquivo a para o local b.

Este caderno me ajuda de duas maneiras: primeiro, fornecendo um local para encontrar respostas para perguntas feitas anteriormente e resolvendo problemas; depois, reforçando o conhecimento, anotando-o (como explicar para outra pessoa).

É claro que, de tempos em tempos, extravio o referido caderno ...

É para isso que serve um sistema de gerenciamento de projetos / problemas, como TRAC, Jira ou o que você tem. No trabalho, coloquei comentários detalhados, procedimentos, dependências em nosso TRAC e Jira e, assim, quando enfrentamos um problema visto anteriormente, uma simples pesquisa nos dá a resposta.