Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
Dicas de como contribuir com open source by @rogeriopradoj

Olá, vamos para algumas dicas de como contribuir com opensource!

Procure seguir o fluxo base que o GitHub ensina para nós

O pessoal do GitHub tem um guia que ensina o GitHub flow, https://guides.github.com/introduction/flow/. A base que ele nos ensina é:

  • crie um branch para a alteração que você vai fazer
  • faça os commits (ou o commit único) das suas alterações
  • abra o pull request
  • espere a aprovação do responsável pelo projeto
  • be happy!

Realmente vale a pena ler o guia. É um texto de cinco minutos, interativo, acesse: https://guides.github.com/introduction/flow/

Tenha pelo menos dois repositórios remotos: origin e upstream

Documentação


O origin é o endereço do seu fork lá no GitHub.

O upstream é o endereço do repositório original para o qual você vai contribuir.

Para ver na sua linha de comando o que está configurado:

git remote -v

Se você vir na saída desse comando tanto o origin quanto o upstream, beleza! Caso contrário (se só aparecer o origin), vamos ver como fazer para ter também o upstream.

Tomemos como exemplo:

Seu fork, lá no GitHub ficaria: zezinho/ManoWars (https://github.com/zezinho/ManoWars.git)

Em geral, o que fazemos depois é um apenas um git clone. O que falta aí é mais um comando: git remote add. Esse comando serve para adicionar repositórios remotos ao seu repositório local.

Quando você faz um git clone, automaticamente é adicionado o repositório remoto origin. Com o git remote add você pode adicionar quantos outros você precisar.

Se você estiver clonando pela primeira vez (digamos que você acabou de forkar o projeto oficial lá no GitHub):

git clone https://github.com/zezinho/ManoWars.git
git remote add upstream https://github.com/rogeriopradoj/ManoWars.git

Caso você já tiver clonado o projeto na sua máquina:

git remote add upstream https://github.com/rogeriopradoj/ManoWars.git

É isso aí, rode agora o comando

git remote -v

e veja se você já tem o origin (seu fork no GitHub) e o upstream (repositório oficial no GitHub).

Procure não alterar o branch master

A ideia principal é que o branch master ande junto com o branch master do projeto principal.

E como você faz as suas alterações? É fácil: crie sempre um branch para fazer as suas alterações!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.