Sexta-feira 13 e Código Assustador! Boo 👻💻

O dia mais supersticioso do calendário chegou! Aproveitei para dar "arrepios na espinha" de vocês com esse código. Especialmente se você está começando na programação, fique aqui comigo que vou explicar por que é ruim escrever um código assim.

1. Nomes misteriosos de variáveis: Usar nomes como "cN," "t," e "arr" não ajuda a entender o que as variáveis representam. Isso é ruim porque dificulta a vida de outros programadores, inclusive a sua no futuro. Lembre-se: "tempo é dinheiro", e não é interessante fazer seus colegas perderem horas decifrando o que você quis dizer.

2. Um feitiço com variáveis em diferentes idiomas: No nosso código, termos como "contador" (em português) e "average" (em inglês) se misturam, criando um caos linguístico. Para evitar essa confusão, é importante manter consistência nos nomes das variáveis e usar um único idioma.

3. Um while de tirar o sono: O uso de um loop "while" nesse contexto parece mais um labirinto do que uma solução simples. Programação deve ser como seguir uma trilha clara – às vezes nem tanto –, não um passeio em uma casa assombrada! Talvez um simples "for" resolvesse o problema de um jeito mais claro. Saber a hora de usar cada ferramenta também é uma ótima habilidade.

4. Os polêmicos comentários: Se você precisa ouvir as vozes do seu eu do passado (comentários) para entender o que foi feito, algo está errado. É claro que há casos em que comentários são bem-vindos, mas no caso do código de exemplo, eles poderiam ter sido evitados se as dicas acima tivessem sido aplicadas.

Quis fazer este artigo porque muito se fala de boas práticas e elas não precisam ser mais assustadoras do que um gato preto no fim da rua (embora eu particularmente acredite que um gato preto no fim da rua significa sorte e um novo amigo hahaha); algumas mudanças simples podem fazer toda a diferença! E é claro que o clean code não se resume a isso, mas fica aqui o convite para quem ainda nem cogitou pesquisar sobre o assunto com medo de ser um monstro de 7 cabeças.

Por hoje é isso, pessoal. Se você identificar algo mais que pode ser melhorado, sinta-se à vontade para compartilhar aqui nos comentários.