Carlos Brando

Nome do Jogo

A força dos comentários no GitHub

Eu sempre tenho falado por aqui e no podcast sobre o GitHub, é não por menos que este projeto tem me chamado tanto à atenção. Um dos recursos mais legais que vi é a possibilidade de incluir comentários sobre o código de terceiros.

Nos grandes projetos, comentar o código está virando mania. Veja por exemplo este caso no próprio Rails. Joshua Peek comitou (hmm… como se diz isto em bom português?) um patch no trunk do Rails onde ele incluiu um arquivo .empty em cada diretório vazio do Rails, para que o GIT mantenha aquele diretório.

Acontece que normalmente é criado um arquivo .gitignore para isto. Claro que o nome não faz diferença, mas virou um padrão. Algum tempo depois alguém comentou:

Depois disto várias pessoas começaram a opinar sobre o assunto até que dois dias depois Joshua mudou o nome dos arquivos para .gitignore, satisfazendo a comunidade.

É ou não é um recurso interessante?

Comments