Documentação: um trabalho que deixamos de lado

Hoje vou falar um pouco de documentação. Essa é a tarefa que um programador acaba deixando mais de lado e muitas vezes não é bem feita ou realmente não é feita. Não é todo lugar que não tem documentação. Mas ter uma vasta e boa documentação não é um trabalho fácil e exigi um esforço de equipe. Seguindo o texto, o maior desafio para uma documentação ser eficiente é manter ela atualizada. Falando exclusivamente sobre minha experiência, alguns fatores que mais atrapalham são fazer documentações separadas para área de negócios e interna; O local onde vou armazenar a documentação e o tempo. Quando eu olho o tempo que tenho para desenvolvimento, vejo que estamos melhorando, mas ainda falta separar uma horinha para fazer uma documentação.

Talvez você ache que seja preguiça ou má vontade, mas uma das coisas que realmente é difícil é passar essa importância durante o período de sprint. Mas também acontece a falta de hábito de sempre colocar a documentação como parte do desenvolvimento. Outro ponto também é saber o momento de documentar algo e isso também é um desafio, pois tem informações que podem ser triviais ou não. Por isso, é muito importante essa discussão seja feita pelo time e a decisão seja feita em conjunto para não perder tempo com algo que não funciona.

Segue sugestão de texto:

https://youtu.be/ORhz5-fQg2g