Gerando Documentação: Ant + Xref + javadoc com UML  XML
Índice dos Fóruns » Assuntos gerais (Off-topic)
Autor Mensagem
Thiago Senna
GUJ Master
[Avatar]

Membro desde: 11/02/2005 08:08:02
Mensagens: 1595
Offline

Olá GUJ's!

Quero perguntar neste post sobre geração de alguns relatórios para a documentação do projeto. Infelizmente consegui encontrar muito pouco sobre isso na net! Eu sei que o maven faz muitas das coisas que vou citar, no entanto eu quero usar ant, e não maven.


Do que eu preciso para criar uma documentação (tipo uma página) onde eu possa navegar pelo código fonte do projeto. Um exemplo disso seria o relatório xref que o maven gera, e um exemplo pode ser encontrado aqui! De quais bibiliotecas eu preciso? Onde eu consigo a documentação (tasks do ant por exemplo) para fazer isso?



Na documentação (javadoc) do spring, além de possuir o javadoc tradicional, ele também possui diagramas UML representando todas as classes! Veja um exemplo aqui! Do que preciso para conseguir gerar uma documentação como este em meus projetos?


Desde já Agradeço!
Thiago Senna

This message was edited 1 time. Last update was at 11/08/2005 13:01:27

[Email]
Mauricio Linhares
Moderador
[Avatar]

Membro desde: 09/01/2005 23:28:22
Mensagens: 3717
Localização: João Pessoa, Paraíba - Brasil
Offline

Assim, sem querer ser chato, mas porque você não pode usar o Maven?

Meu blog sobre desenvolvimento | My Last.fm | @mauriciojr

Screencast de Introdução a linguagem Objective-C
[WWW]
Thiago Senna
GUJ Master
[Avatar]

Membro desde: 11/02/2005 08:08:02
Mensagens: 1595
Offline

Por que eu acho que trabalhar com ant é de certa forma mais ágil do que trabalhar com maven! Sem contar q a documentação para ant é mais farta!

Tive também alguns problemas com o Maven na hora de rodar testes unitários dos meus DAO's. Ele funfa no eclipse, mas no maven sem chance! (não testei no ant ainda).


Outra problema que tenha é não tá valendo a pena eu ter um repostiório para minhas libs! O projeto é desenvolvido na minha casa, na casa de outros dois amigos e na faculdade! O ideal é transportar o projeto por completo, tá sendo dispendioso ficar configurando o repositório em tudo quanto é canto, sem contar que não temos um servidor global (a faculdade não disponibiliza!) para o projeto!

Também estamos fazendo um controle de configuração do projeto, e precisamos automatizar a criação do zip do projeto. (Nosso repositório é o gmail.. hehe!) O ant vai ser mais útil, principalmente para conseguirmos separar src de lib! Isso é necessário pq alguns dos ambientes de desenvolvimento está usando conexão discada!

Bom, o motivo é basicamente este!
[Email]
LeandroSeverino
JavaBaby
[Avatar]

Membro desde: 24/09/2003 16:32:50
Mensagens: 90
Localização: Canoas - RS
Offline

Opa,
Também tenho muito interesse.

Atenciosamente,
===========================================================
Leandro Severino - Analista Desenvolvedor
http://www.lstecnologia.com.br - Conhecimento e Profissionalismo.
Blog: http://www.leandro.inf.br
===========================================================

[WWW] [MSN]
jack_-_ganzha
JavaEvangelist
[Avatar]

Membro desde: 31/03/2003 13:18:12
Mensagens: 315
Localização: Recife - Pernambuco
Offline

Xref vc faz com o Java2HTML e para a documentação do Spring, use o Spring BeanDoc.

valeuz...

Marcos Silva Pereira

http://www.javafree.org
http://marcospereira.wordpress.com
[MSN] [ICQ]
Thiago Senna
GUJ Master
[Avatar]

Membro desde: 11/02/2005 08:08:02
Mensagens: 1595
Offline

Valeu Jack...

Observação: Adicionando tópico no meus favoritos!
[Email]
 
Índice dos Fóruns » Assuntos gerais (Off-topic)
Ir para:   
Powered by JForum 2.1.8 © JForum Team