Contribua via Github

Pré-requisitos

Para poder contribuir via pull request, existem vários pré-requisitos:

Saber usar um mínimo de Git
Tenha uma conta no Github
Tenha uma bifurcação do projeto no qual deseja contribuir

Antes de entrar nos detalhes, será necessário fazer uma pequena observação sobre o vocabulário. Aqui está um pequeno glossário de palavras que usamos constantemente com o Git/Github:

repo: Abreviação de "Repositório". Usamos esta palavra para designar um conjunto de arquivos versionados com Git.
branch: Este é um branch em um projeto Git. As ramificações permitem que você crie uma versão paralela do código em algum ponto da história.
master: Designa o ramo principal do repo.
origem: Designa o repositório remoto. Hospedado no Github, por exemplo.
pull request: Esta é a operação que permite propor uma modificação de código para um projeto no Github.
fork: Este é um repositório que é uma cópia de outro repositório. Isso permite que você comece a partir de um projeto existente para modificá-lo, melhorá-lo, corrigi-lo ou fazer outra coisa com ele.
upstream: No caso de fork, designa o repo de onde provém o fork.
fetch: Esta é a operação que consiste em recuperar os dados do remoto localmente.
push: Esta é a operação que permite enviar dados locais para o remoto.

Configuração

Garfo

A primeira coisa a fazer é ir ao Github, para criar um fork do projeto para o qual você deseja contribuir.

Por exemplo, para contribuir com o cliente Leek Wars, acesse: Leek Wars Client

Em seguida, basta clicar no botão "fork" no canto superior direito.

Ao "bifurcar" o projeto, o Github criará um novo repo em sua conta. Esta será uma cópia do projeto original.

Em seguida, obtenha o endereço do seu repositório github, por meio do endereço url ou clicando no botão verde "Clone or download".

Vá para o local onde deseja colocar seu repo local e use o comando: git clone \ Não se esqueça de substituir "\".

Então. Você criou uma bifurcação do projeto e a recuperou localmente, em sua máquina. Mas há mais uma coisa a fazer para poder continuar a usá-lo sem preocupações no futuro.

A montante

Você deve então configurar o upstream, que permitirá atualizar seu repo a partir do projeto.

O comando git remote -v permite listar os endereços remotos configurados.

origem https://github.com/YOUR_USERNAME/YOUR_FORK.git (buscar) origem https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

Por enquanto, você deve ver dois endereços configurados como origem. Um em fetch, quando você deseja repatriar novos recursos de seu controle, seu repositório hospedado no Github. E o outro em push que, ao contrário, permite que você envie suas notícias locais para o repo remoto.

Para isso, adicionaremos o upstream. Para fazer isso, obtenha o endereço do projeto que você acabou de bifurcar. Sempre através da url, ou do botão "Clone or download".

O comando para adicionar o upstream é: git remote add upstream \

Se você executar o comando git remote -v novamente, deverá ver quatro entradas. Dois para a origem e dois para o a montante. Cada um duplicado em um fetch e um push.

origem https://github.com/YOUR_USERNAME/YOUR_FORK.git (buscar) origem https://github.com/YOUR_USERNAME/YOUR_FORK.git (push) upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (buscar) upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Você está pronto para contribuir agora!

Mantendo-se atualizado

(Etapa não necessária se você apenas fork.)

As chances são de que o projeto para o qual você está contribuindo não seja imutável. As pessoas que cuidam dela farão com que ela evolua. Outras contribuições serão potencialmente aceitas.

Seu repo pode, portanto, tornar-se rapidamente obsoleto. E isso pode ser um problema.

Se originalmente um arquivo continha "A", e você deseja enviar uma contribuição para alterar esse "A" para "B". Nesse ínterim, talvez outra pessoa tenha feito uma alteração deste "A" para "C".

E quando você propor sua modificação, haverá um conflito. Não é possível alterar "A" para "B" porque "A" não está mais presente no arquivo.

Resumindo, é importante manter o repo atualizado para evitar surpresas desagradáveis.

Não se preocupe, agora que você configurou o upstream, será muito fácil!

A primeira coisa a fazer é obter o novo m