Caros,
Algum de vocês utiliza a técnica de Fluent Interfaces? Aqui na empresa estamos em uma discussão a respeito da necessidade de geração de javadoc para métodos e classes (a documentação é necessária vistos requisitos de grandes clientes). Alguns defendem a ideia que é necessário comentários para classes de domínio (POJO) assim como para seus atributos. Porém o impasse está na necessidade de geração de comentários para métodos fluentes, intuitivos. Por exemplo, qual a real necessidade de comentar e gerar documentação para o método: recuperarUsuarioPorID(…)?
Qual é a política na arquitetura de seus sistemas?
