Controle de versão e documentação de projeto

[barboza]

Quem usa?

Qual usa?



51, acho que isso merece um novo assunto no forum.

[Paulo]

Quem usa?

Qual usa?



51, acho que isso merece um novo assunto no forum.

Aqui na empresa nós utilizamos o SVN para controle de versão e a documentação dos projetos é feita em cima de templates que criamos aqui para nos auxiliar na época em que foi feita a implantação da ISO. Os templates abrangem diversos itens de controle de projeto e ao longo do tempo na medida em que necessitamos de mais informações, ou outras necessidades, vamos alterando esses templates.
Durante as fases de desenvolvimento do projeto vamos documentando todas as ocorrências ao longo do tempo, tanto de HW quanto de SW e outras partes como: mecânica, lay-out, manual, etc...

Espero ter ajudado, qq coisa posta aí.

Até +...
Paulo D.

[barboza]

Será que só nos dois usamos Paulo?

Achei que poderíamos usar este espaço para trocar experiências com SVN, TRAC, MANTIS, Bugzilla, ........

[Peters]

Barboza, geralmente eu uso o Doxygen. Ele tem uma sintaxe para os comentários, que são usados posteriormente para gerar a documentação. Dessa forma ao mesmo tempo que vc programa, vai deixando a documentação praticamente pronta.

Pega por exemplo a documentação do UiP é toda feita com doxygen. Dá uma olhada:
http://www.sics.se/~adam/uip/uip-1.0-refman/

[chipselect]

eu uso javadoc (pra java), csv para controle de versão

[ivan]

Peters,

Onde obtenho infos sobre o uso do Doxygen? Baixei um pgm da internet que tem a documentação neste formato e não sei como usá-lo.

Obrigado.

[Peters]

Tá aqui:

http://www.stack.nl/~dimitri/doxygen/manual.html
http://www.stack.nl/~dimitri/doxygen/starting.html
E esse que é bem didático:
"10 Minutes to document your code" http://www.codeproject.com/KB/tips/doxysetup.aspx

dá uma olhada na página dele, pois tem uns plugins para diversos editores. Existem tbem algumas ferramentas para gerar os arquivos de configuração para ele, já que o oficial (Doxywizard) roda em Linux somente.