Ouvindo Opiniões

Prazo! Prazo! Prazo! Alguém já teve pesadelos com isso ou só eu?

Bom, documentação é sim necessária, eu diria indispensável, principalmente durante o desenvolvimento, e na minha opinião deve ser feita "on the fly" (http://en.wikipedia.org/wiki/On_the_fly)... aqui na empresa aplicamos conceitos e técnicas de Extreme Programming (http://www.extremeprogramming.org/) na maioria dos nossos projetos e precisávamos adequar o processo de documentação a esta realidade.

O problema é que a documentação tem de ser feita de forma prática, eficiente e que consuma o menor tempo possível... recentemente adotamos o DelphiCodeToDoc (http://dephicodetodoc.sourceforge.net/), uma excelente ferramenta gratuita para automatizar o processo de geração de documentação durante o desenvolvimento. Isso, associado a um processo de controle de requisitos implementado com PhpCollab (www.php-collab.org) ou Borland StarTeam (www.borland.com/br/products/starteam/) tem se mostrado mais do que suficiente para as nossas necessidades.

Creio que o mais importante seja adequar o processo de documentação à metodologia de desenvolvimento de software escolhida, tomando por base nos conceitos de engenharia de software e na realidade da empresa e de seus projetos. Uma vez definidos estes padrões é preciso segui-los à risca, e incluir nos prazos as demandas de tempos de cada etapa, de forma a garantir o atendimento dos requisitos de qualidade do produto final.