Ouvindo Opiniões

Sabemos que a documentação de um sistema faz parte do processo de desenvolvimento. Porém, uma documentação completa demanda muito tempo e geralmente acaba ficando em segundo plano quando há falhas no projeto ou "surpresas" de última hora. Mas assim como é básico ter documentos de requisitos, há um nível de documentação que considero indispensável: documentação básica das fontes, diagrama de entidades e relacionamentos, dicionário de dados, senhas, visão geral dos processos, parâmetros de funcionamento e instalação. Sem estas informações, que o próprio desenvolvedor necessita para reparar ou modificar o sistema, não vale a pena assumir compromissos.

No caso de trabalho em equipe, é preciso ter preocupação com quem irá assumir o projeto. É inadmissível que uma equipe tenha que investigar como funciona uma aplicação desenvolvida por ela mesma.

Na verdade, nunca consegui participar de um projeto de desenvolvimento que não fosse "pra ontem". Mas nunca deixei de documentar o essencial. Já tive experiências dramáticas ao assumir projetos de uma equipe que não documentava nem mesmo os nomes das tabelas, e em alguns casos, gastei mais tempo na investigação de seu funcionamento que nas implementações novas. Por isso, considero que não vale a pena deixar de documentar pra entregar no prazo combinado. Que projeto é este que ignora o processo de documentação? Devemos nos valer de um ditado muito comum em repartições públicas: "Urgente é aquilo que você não fez em tempo hábil e quer que eu faça em tempo recorde".