A importância de documentar sistemas

PDF

7-p1

 

"Por detrás de cada realização, pequena ou grande, encontra-se um planejamento. Lembre-se, se você realmente quer ver suas metas se concretizarem, aprenda a planejar."

Dados estatísticos mostram que de 47% a 62% do tempo gasto em manutenção de sistemas é despendido na tentativa de entender os aplicativos, e que ler código fonte custa 3,5 vezes mais do que ler a documentação.
Mas não é só, os dados mostram ainda que:  

  • 53% dos defeitos são descobertos em trechos tidos como corretos;
  • 10% dos defeitos é de lógica;
  • 79% dos defeitos são causados por entendimento incorreto.

Outros fatores demonstram, de forma definitiva, a importância da documentação de sistemas:

  • O novo modelo organizacional (analista voltado a informação e programação através de fábrica de software) implica na necessidade de documentar sistemas.
  • A demanda pelo desenvolvimento de novas soluções tem forçado a liberação de recursos valiosos alocados à manutenção de sistemas;
  • A busca pela qualidade e produtividade tem levado as organizações a documentarem seus processos e sistemas.

É interessante considerar que não basta apenas elaborar uma documentação inicial perfeita, é preciso também que a documentação elaborada acompanhe cuidadosamente as manutenções e alterações nos sistemas, para que seja mantida a integridade e confiança da informação contida na documentação.