Escolha cuidadosa de nomes de métodos:

• Nomes devem seguir convenções (Item 68).
• Priorize nomes compreensíveis e consistentes com o pacote e com o consenso geral.
• Evite nomes longos.

Não exagere em métodos de comodidade:

• Cada método deve “fazer sua parte do trabalho”.
• Muitos métodos dificultam o uso, manutenção e documentação da API.
• Ofereça métodos abreviados apenas se forem muito usados.

Evite listas longas de parâmetros:

• Limite a quatro ou menos parâmetros.
• Listas longas são difíceis de lembrar e suscetíveis a erros.
• Parâmetros do mesmo tipo em sequência podem causar confusão.

Três técnicas para reduzir listas longas de parâmetros:

• Dividir o método em vários métodos menores.
• Criar classes auxiliares para grupos de parâmetros.
• Usar o padrão Builder para métodos com muitos parâmetros, especialmente os opcionais.

Prefira interfaces a classes nos parâmetros:

• Use interfaces, como Map, em vez de classes específicas, como HashMap, para maior flexibilidade.

Prefira enums a booleanos em parâmetros:

• Enums tornam o código mais legível e facilitam futuras expansões de opções, como no exemplo do termômetro com escala de temperatura.
• Essas práticas ajudam a criar APIs mais fáceis de usar e menos suscetíveis a erros.