Utiliza-se Javadoc ???  XML
Índice dos Fóruns » Assuntos gerais (Off-topic)
Autor Mensagem
ASOBrasil
JavaEvangelist
[Avatar]

Membro desde: 25/06/2005 20:57:30
Mensagens: 402
Localização: São Paulo
Offline


Pessoal,

Hoje em dia é pratica comum utilizar Javadoc nas empresas Ou o Javadoc foi criado para ajudar os profissionais de Java mas as pessoas acabaram não aderindo ao uso (principalmente nas empresas)


valeu, André

Java Examples || Useful links for web developer
[Email]
Rafael Nunes
Moderador
[Avatar]

Membro desde: 09/10/2003 13:41:06
Mensagens: 2890
Localização: sao bernardo do campo
Offline

Foi criado exatamente para ajudar o desenvolvedor, mas já vi muito projeto que não colocam comentários nos métodos, o que é horrível ficar tentando adivinhar o que o método faz.
É a melhor forma de expor a interface dos seus objetos aos Clientes. Ah não ser que você seja muito maldoso e prefira que eles fucem no código fonte pra descobrir o que precisam.

This message was edited 1 time. Last update was at 24/08/2005 08:59:37


------------------------------------------------------------------
"Think different? I'd be happy if most people would just think..."

http://www.yaw.com.br
http://twitter.com/rafanunes
http://twitter.com/youandwe
[Email]
pcalcado
Moderador
[Avatar]

Membro desde: 08/03/2004 17:19:35
Mensagens: 5174
Localização: Sydney - Australia
Offline

Mais que o documento HTML gerado, comentários em JavaDoc ajudam muito nas IDEs.

Existem emrpesas com políticas rígidas sobre comentários, mas este tipod e ambiente costuma resultar em:






Phillip Calçado "Shoes"
http://fragmental.tw/
http://blog.fragmental.com.br/
"It is unfortunate that much of what is called 'object-oriented programming today is simply old style programming with fancier constructs." - Alan Kay
[Email] [WWW] [Yahoo!] [MSN]
Licuri
Java Ninja
[Avatar]

Membro desde: 22/12/2004 10:02:40
Mensagens: 282
Localização: SP
Offline

ASOBrasil...O javadoc pode ajudar em uma manutenção futura do sistema, e hoje em dia o javadoc jaz parte de padrões de metodologias, pois aqui na empresa que trabalho javadoc é obrigado pois seguimos o CMM.
[MSN]
 
Índice dos Fóruns » Assuntos gerais (Off-topic)
Ir para:   
Powered by JForum 2.1.8 © JForum Team