sexta-feira, 22 de agosto de 2008

Documentação em dia


Um dos grandes desafios, principalmente em projetos de TI, é manter a documentação em dia. Em alguns projetos, até tomarmos os cuidados necessários para a elaboração dos documentos, por mais simples que possam ser. O grande problema consiste nas atualizações que os documentos precisam sofrer durante o período de evolução do projeto, muitas vezes pressionados por prazos ou orçamento.

O que acabamos fazendo é realizar as mudanças no projeto e deixarmos para atualizar a documentação no momento seguinte, o que acaba não acontecendo e quando vemos já estamos realizando novas mudanças chegando em um momento onde não se consegue mais atualizar.

Sei o quanto é difícil manter atualizada, ainda mais quando temos mudanças onde gastaremos mais tempo para versionar e atualizar a documentação do que para realiza-la.

Deixo abaixo algumas sugestões:

  • Reserve horários em seus projetos apenas para cuidar da documentação.
  • Atualize sua documentação antes de realiza as mudanças necessárias no projeto.
  • Valide sempre com as partes interessadas a documentação produzida, diminuindo assim retrabalho desnecessário.


Uma documentação em dia, além de facilitar o andamento e encerramento do projeto com sucesso, nos permite uma posterior continuidade, se necessário.

Espero que tenham gostado e convido a deixarem nos comentários como você mantém sua documentação em dia. Até a próxima.

Nenhum comentário:

Postar um comentário