O perfil perfeito no GitHub

tiagodanin

Tiago Danin

Posted on April 7, 2019

O perfil perfeito no GitHub

Vou dar algumas dicas de como criar um perfil apresentável no GitHub.

  • Faça parte de comunidades open source e contribua para elas. Os melhores projetos para fazer contribuição são aqueles que você usar ou já está familiarizado com as ferramentas, pacotes, aplicativos e até mesmo jogos.
  • Tenha repositórios organizados.
  • Não uso o mesmo repositório para dois guarda dois projetos diferentes.
  • Crie um README, ele tem que ter minimo a descrição do software e instruções para instalações e como fazer o seu uso.
  • Tenha uma padrão universal de organização dos tópicos de seu README (Você vai usar eles em outros projetos como ponto de partida).
  • Para repositórios com o arquivo "package.json", recomendo usar o Package-Json-to-Readme ou Gen-README como ponto de partida do README.
  • Faça commits que descrever a modificação realizada (Nada como "Update X.js" ou "up").
  • Escolha uma licença, o site escolhaumalicenca.com.br pode ajuda você nisso.
  • Não coloque muitos arquivos na raiz, o ideal seria você usar subdiretórios para organizar os arquivos.
  • Use os "badges" para mostrar status do projeto. Há vários desses no site shields.io.
  • Sempre que possível crie testes.
  • Use ferramentas de CI (Continuar integração), para fazer build e roda testes. Recomendo usar o Travis CI a integração dele com GitHub é perfeita e ainda tem "badges"
  • Tenha um site para seu projeto, assim fica mais fácil de acha ele fora do GitHub. Caso não queira ter o trabalho de criar um do zero use o GitHub Pages.
  • Separe seus forks em uma organização. Dica: Você pode manter eles sempre atualizados usar o bot Pull.
  • Não faça gambiarras :), lembre-se que o mundo todo vai ver seu código.
  • Evite demorar muito responder issue ou pull requests.
  • Tenha foto de perfil apresentável e uma rápida descrição.

Outras sugestões em github.com/training-center/forum/issues/23.

💖 💪 🙅 🚩
tiagodanin
Tiago Danin

Posted on April 7, 2019

Join Our Newsletter. No Spam, Only the good stuff.

Sign up to receive the latest update from our blog.

Related

O perfil perfeito no GitHub
ptbr O perfil perfeito no GitHub

April 7, 2019