Vale lembrar (recomendação do Uncle Bob) que o tamanho do nome de uma variável deve ser diretamente proporcional ao seu escopo. Quanto menor o escopo, menor pode ser o nome de uma variável; quanto maior o escopo, maior deve ser o nome de uma variável. Ex: dentro de um loop (escopo bem reduzido) é comum utilizar nomes como i ou j ou k. Para variáveis globais (escopo maior) é recomendado utilizar nomes de maior tamanho. Ex: limite_tentativas_call_api.

Para funções é o contrário: quanto menor o escopo, maior o nome de uma função. Quanto maior o escopo, menor o nome de uma função. Ex: funções len() e max(), são funções globais (built-in) e com maior escopo. Uma função com escopo bem reduzido, pode ser uma função usada dentro de outra função, deveria ter um nome maior, especificando o procedimento específico que ela faz. Ex: uma função chamada valida_sintax_senha() é algo específico, chamado apenas na rotina de login (escopo reduzido), só pra verificar se a senha tem letras, números, sem sequências, etc.

E aí, @teknolista! 🚀

Mandou bem demais nesse ponto! 👏 Faz total sentido essa relação entre escopo e nomeação. Variáveis de loop com i, j e k são tipo o feijão com arroz do código, mas se começamos a ver um xpto solto no meio do projeto… já bate aquele desespero. 😂

E sobre funções, perfeito! Quanto menor o escopo, maior o nome pra deixar tudo explicadinho. Afinal, ninguém quer abrir um código e encontrar uma função doStuff() e tentar adivinhar o que ela faz, né? 🤯

Valeu pelo complemento, bora sempre espalhar o evangelho do código limpo! 🙌🐍