Warning: fopen(logs/log_ouvindo_opinioes.txt) [function.fopen]: failed to open stream: No such file or directory in /home/storage/6/a1/fc/edudelphipage/public_html/includes/edp_log.php on line 6

Warning: fwrite(): supplied argument is not a valid stream resource in /home/storage/6/a1/fc/edudelphipage/public_html/includes/edp_log.php on line 8

Warning: fclose(): supplied argument is not a valid stream resource in /home/storage/6/a1/fc/edudelphipage/public_html/includes/edp_log.php on line 9
 EduDelphiPage - Ouvindo Opiniões | Documentação de sistema x Prazo de entrega

Ouvindo Opiniões

Documentação de sistema x Prazo de entrega

Opinião escrita por Márcio Henrique da Silva

Sobre o autor: Bacharel em Sistemas de Informação
Especialista em Engenharia de Sistemas
Gerente de TI das Lojas Edmil
Professor de Eng. de Software e Banco de dados (Faceca)
Programador Delphi

Contato: marciohsilva@yahoo.com.br

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".

Comentários

Nenhum comentário foi feito ainda
 

"Ouvindo" Opiniões (as mais lidas)

Em breve, aguarde!!!

Pharetra Sed Tempus

Morbi sit amet mauris Nam vitae nibh eu sapien dictum pharetra. Vestibulum elementum neque vel lacus. Lorem ipsum dolor sit dolore phasellus pede lorem proin auctor dolor loremmassa phasellus sit. More…

Outras edições da Revista Active Delphi