Comentários legais, avisos sobre consequências técnicas ou explicações de algoritmos complexos de terceiros são aceitáveis. 3. Formatação e Estrutura
Use substantivos para classes ( Usuario , Pedido ) e verbos para métodos ( enviarEmail , calcularTotal ). Funções Pequenas e Especializadas CГіdigo limpo
A regra de ouro é: se um nome exige um comentário para explicar seu propósito, então o nome não é bom o suficiente. int d; // dias passados Bom: int diasPassados; Funções Pequenas e Especializadas A regra de ouro
O conceito de (ou Clean Code ), popularizado pelo livro homônimo de Robert C. Martin ("Uncle Bob"), é um dos pilares fundamentais para qualquer desenvolvedor que deseja elevar a qualidade do seu trabalho de "apenas funcional" para "profissional e sustentável". Adotar o Clean Code exige disciplina e prática constante
Adotar o Clean Code exige disciplina e prática constante. No início, pode parecer que você está gastando mais tempo "pensando em nomes" do que programando, mas o retorno sobre esse investimento vem rapidamente na forma de menos bugs e uma base de código que não causa medo ao ser alterada.