Oioi besties, tudo bem?
Este é o primeiro de uma série de artigos sobre o livro Clean Code - Robert C. Martin, em que pretendo trazer, de forma sucinta, anotações e comentários sobre o que aprendi com a leitura.

Logo no prefácio, é citada a metodologia 5S - até então, eu só conhecia o 5S utilizado em ambiente industrial, graças ao trabalho do meu pai - cujos conceitos são:

• Seiri (ou utilização, em português);
• Seiton (ou organização, em português);
• Seiso (ou limpeza, em português);
• Seiketsu (ou normalização);
• Shutsuke (ou disciplina);

Já no primeiro capítulo (Clean Code), o autor nos faz pensar sobre o que é o código limpo, como deve ser feito e sua função. Gosto bastante do trecho que diz que o código limpo pode ser lido, compreendido e alterado por um desenvolvedor diferente do autor. Além disso, o código deve possuir testes de unidade/unitários/de aceite, possuir nomes significativos e poucas dependências. Ademais, evitar duplicidade de código também é importantíssimo.

No segundo capítulo (Meaninful Names), é abordada a importância de nomes bem definidos para classes, atributos, métodos e responder questionamentos importantes, como: "Por que existe?", "O que faz?" e "Como é usado?"; deve evitar desinformação; o nome de uma classe deve conter um substantivo e evitar verbos; em contrapartida, métodos devem possuir verbos em seu nome; manter um contexto significativo e evitar o excesso de informação gratuita.

O assunto tratado é função (Functions) e acredito que o principal ponto trazido é: funções devem fazer apenas uma coisa, fazê-la bem e apenas isso. Ademais, devem ser curtas, evitar misturar abstrações pois pode dificultar a leitura e compreensão do que é feito.

Bom, por hora esses são os pontos que acho interessante ressaltar - e são coisas que eu tenho certeza que vou consultar várias vezes - então espero que seja útil pra quem deseja um brevissimo resumo ou instigue a curiosidade para ler o livro e aprender de modo mais detalhado.

Fontes utilizadas:

• O que é 5S
• Link do ebook