Código Limpo - Comentários

Notas do episódio

No quarto capítulo de Código Limpo, intitulado "Comentários", Robert C. Martin aborda o uso correto e responsável dos comentários no código. Ele argumenta que comentários geralmente indicam um "remendo" para código mal escrito e incentiva os programadores a priorizarem a clareza do próprio código, reduzindo a necessidade de explicações adicionais. Martin destaca que, embora existam situações em que comentários são úteis – como para explicar decisões complexas ou avisos sobre possíveis armadilhas –, a maioria das informações deve ser transmitida pelo próprio código, através de nomes claros e funções bem estruturadas. Ele apresenta práticas para evitar comentários redundantes ou desatualizados, que mais confundem do que ajudam, e incentiva o uso de técnicas de código limpo para garantir que o código “fale por si mesmo”. O capítulo reforça a ideia de que bons comentários são raros e estratégicos, enquanto o código limpo, autoexplicativo, é a meta ideal.