Entrelinhas do Código

Código Limpo - Comentários


Listen Later

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.

...more
View all episodesView all episodes
Download on the App Store

Entrelinhas do CódigoBy Tiago de Abreu