Baaam!

Adotar padrões pode parecer chato no início, mas é a melhor opção para manter o código legível e fácil de manter. Talvez, não exista nada pior que um código mal formatado, com identações malucas (com tabulações e espaços juntas), funções com nomes escritos de forma aleatória e sem sentido, e vários outros problemas que dificultam a leitura, não somente de terceiros, mas do próprio autor do código depois de uma semana.

Pensando nisso, foram desenvolvidos os guias de estilo de código. Geralmente, as comunidades de linguagens desenvolveram seus padrões, até mesmo para facilitar a vida dos desenvolvedores, e até mesmo na construção de frameworks. A ideia desse post é apresentar alguns dos padrões que conheço, então se você conhece algum outro, deixe nos comentários.

Ah, antes de continuar, é bom lembrar que algumas empresas tem seus próprios Style Guides, então é sempre bom passar saber se na sua tem algum. #FicaADica

Por padrão, vamos por ordem alfabética. (:

C

Um dia, em uma aula de Estrutura de Dados, fiquei curioso pra saber se existia algum guia para a linguagem C e fiquei contente em encontrar pelo menos 2. São eles:

Não encontrei uma fonte oficial do guia da NASA, mas mesmo assim vale a pena dar uma olhada, é um material bacana.

CSS

CSS é sem dúvidas umas das coisas mais legais pra mim. Por ser fácil de começar brincar com CSS, a chance de se encontrar um código bagunçado é muito alta. Existem alguns guias para ajudar a deixar seu código mais estiloso:

Alguns deles falam sobre HTML também, por isso não vou colocar uma seção específica pra HTML aqui.

Existem algumas técnicas muito legais também. Talvez você já tenha ouvido falar em SMACSS, BEM, OOCSS, e por aí vai. Recomendo o post do Jean Carlo Emer: OOCSS, SMACSS, BEM, DRY CSS: afinal, como escrever CSS?.

JavaScript

Por ser a linguagem que está dominando o mundo, o JavaScript tem vários Style Guides, e quando digo ‘vários’, é porque tem muitos mesmo. Vou citar os mais comuns pra mim:

Preciso fazer um gancho pra um projeto sobre JS. Se você não sabe JS, ou acha que não sabe, dê uma lida na série de livros You Don't Know JS. Caso você já saiba ou se sente seguro sobre grande parte da linguagem, nos ajude a terminar essas traduções (:

PHP

Com certeza, PHP é uma das linguagens com uma das comunidades mais ativa, e particularmente, uma das minhas linguagens preferidas. Aqui estão alguns guias bacanas:

Existe o PHP-FIG (PHP Framework Interoperability Group), que cuida das PSRs (PHP Standard Recommendation), padrões gerais para se trabalhar com PHP. É um trabalho muito interessante e eu recomendo que você dê uma olhada em todas as PSRs.

Python

Não tenho muito para falar de Python por não conhecer muito, mas sei que existe o tal da PEP 8 – Style Guide for Python Code, que é um guia de estilo da própria linguagem. Acho que já uma boa referência.

Ruby

Comecei estudar a linguagem Ruby há algum tempo e achei muito bonita. Estou seguindo o style guide do GitHub, mas encontrei outro aqui também, então aqui estão os links:


Alguns desses guias se divergem, outros são bem parecidos, mas isso é bom, dá pra pegar o melhor de cada um.

Não falei de algum que você gosta, ou deixei de falar de alguma linguagem que você conhece e sabe que tem um style guide bacana? Deixe nos comentários, será um prazer aprender contigo!

Espero ter ajudado (:

Até a próxima.