1. O documento discute boas práticas de programação como nomes significativos, pequenas funções, tratamento de exceções e testes de unidade.
2. É recomendado usar nomes que revelem o propósito das variáveis e funções, evitar comentários que podem desatualizar e funções devem fazer uma única tarefa.
3. Testes de unidade garantem código limpo e flexível, fornecendo feedback rápido e maior produtividade.
30. Funções devem ser:
● Pequenas
● Fazer apenas uma coisa
● Ser bem nomeadas
● Devem ser lidas de cima para baixo
● Extrair trechos para funções menores
● DRY
31. Cuidado com a quantidade de parâmetros
Qual é a
quantidade ideal
de parâmetros?
ZERO
37. Uso de comentários
● Esclarecimento
● Alerta de consequência
● JavaDoc em API pública
● Comentário legal
● TODO
● Redundantes
● Longos
● HTML
● Explicando código
● Ao lados de cada chave
● JavaDoc em API NÃO
pública
● Código comentado
39. Alguns cuidados:
● Manter o código bem identado
● Distância vertical
● Função dependente
● Linha de no máximo 120 caracteres
● Classes devem tem o minimo de linhas
possível
41. Exceções
● Usar exceções em vez de retornar código de erro
● Não pode obscurecer a lógica
● Criar testes que forcem a exceção
● Use exceções não verificadas
● Lance exceções com um contexto
47. As 3 leis do TDD
● Você não pode escrever código de produção a menos que ele
tenha um teste de unidade que falha.
● Você não pode escrever mais teste de unidade que o suficiente
para falhar; e erros de compilação são falhas.
● Você não pode escrever mais que o suficiente, para o código de
produção passar em um teste de unidade.