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) :!:
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.
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.