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 Miguel Henley

Sobre o autor: Engenheiro e desenvolvedor de soluções corporativas em Delphi e Java nas plataformas Windows e Linux. Possui interesse em arquitetura de software, objetos distribuídos e algoritmos computacionais de alto desempenho.

Contato: mhenley@datamag.com.br

A documentação de um projeto é um artefato de muita importância no desenvolvimento de um software. Seja a documentação hardcore (para o desenvolvedor), seja a documentação para o usuário final, ela deve estar inserida no contexto do desenvolvimento, fazendo parte de todo o processo.

Considero uma boa documentação tão importante quanto a análise, o projeto, a implementação, os testes unitários e os testes de integração contínua. Infelizmente, o que vemos por aí, é que muitas empresas brasileiras não dão tanta importância à documentação ou deixam essa tarefa para um segundo momento acarretando em uma documentação pobre e muitas vezes desalinhada com a funcionalidade do sistema.

Temos hoje em dia muitas ferramentas que podem mecanizar essa árdua tarefa, podendo gerar desde help's de sistema até manuais em formato de impressão e isso tudo integrado ao IDE. Meu "voto" é para a manutenção contínua da documentação e liberação das atualizações junto com os releases dos sistemas.

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