1) O documento discute técnicas de desenvolvimento de software limpo e testes unitários usando TDD.
2) É enfatizado que nomes significativos, comentários apenas quando necessário, métodos curtos e classes coesas levam a códigos mais legíveis e de fácil manutenção.
3) Testes unitários aplicados desde o início do projeto por meio de TDD tornam o código mais robusto e facilitam refatorações futuras.
10. Desenvolvedor Profissional
Qualquer tolo pode escrever código
que um computador consiga
entender. Bons programadores
escrevem código que HUMANOS
consigam entender.
17. Ward Cunningham
Você sabe que está
criando um código
limpo quando cada
rotina que você le se
mostra como você
esperava...
18. Clean Code
Simples e direto, um desenvolvedor
pode ler.
Cada rotina que você le mostra
como você expressa todas as ideias.
19.
20.
21. Nomes significativos
Faça distinções significativas, use
nomes diferentes dentro de um mesmo
escopo.
Nomes como a1, a2, a3 são o oposto de
nomes que demonstram intenção - são
confusos e não informam nada.
22. Nomes significativos
Evite também usar abreviações ou
trocadilhos, escreva exatamente o
que você quer dizer, o nome deve
ser auto-explicativo.
23. Nomes significativos
É comprovado que um desenvolvedor
passa muito mais tempo lendo
código do que escrevendo, por isso
não se preocupe em economizar
caracteres ao escolher um nome.
25. Comentários
Na verdade, o melhor comentário é
aquele que não precisa ser escrito.
Um dos principais motivos para você
escrever um comentário é porque o
código está difícil de ser entendido.
26. Comentários
Você acha que o código ficou meio
confuso e acha melhor adicionar um
comentário? Não, você precisa
refatorar!
29. Classes e Formatação
A legibilidade do código terá profundo efeito sobre
todas as mudanças que serão feitas, seu estilo e
disciplina sobrevive sobre estas mudanças.
Procure escrever classes com no máximo 500
linhas, classes menores são mais fáceis de se
entender. Já para as linhas de código, tente
estabelecer um limite de caracteres por linha.
30. Classes e Formatação
Uma boa identação ajuda a visualizar
melhor todo o escopo e facilita a
identificação de situações e regras
relevantes.
31. Classes e Formatação
Tente manter conceitos
relacionados mais próximos
verticalmente, para criar um
fluxo na leitura do código.