Lado escuro dos comentários

Não é o que você está pensando 🙂 Apenas uma rápida olhada em como estou usando comentários para organizar melhor meu código.

Alguns desenvolvedores dizem que os comentários poluem o código-fonte e o tornam menos legível. Dependendo das configurações do seu IDE, eu concordo, especialmente se os comentários forem coloridos de forma a competir com o próprio código. Os comentários não devem roubar sua atenção.

É por isso que configurei meus IDEs para exibir comentários em uma cor bastante escura, quase mesclando com o fundo (mas ainda claro o suficiente para ser lido facilmente sem cansaço visual). Dessa forma, eles ficam claramente distintos do código, com o benefício adicional de ajudar na separação dos blocos de código por causa do espaçamento virtual adicionado entre as linhas de código. Dê uma olhada nas imagens abaixo:

Comentários com cor padrão

Comentários obscuros

O primeiro é um esquema de cores mais tradicional, o segundo é a minha configuração atual. Pequena mudança, grande impacto na organização e legibilidade do código.

PS: para texto escuro em fundo claro, logicamente você inverteria as coisas e definiria os comentários para uma cor cinza claro quase branco. Ou ainda melhor: junte-se ao lado negro da força e obtenha um esquema de cores escuras 🙂