loading...
WoMakersCode

[Tutorial Git] fork: Como colaborar com projetos de código aberto

danielle8farias profile image ダニエリ ・3 min read

git tutorial (26 Part Series)

1) [Tutorial] Instalando, configurando e inicializando o Git no Linux 2) [Tutorial Git] Adicionando arquivos no Git 3 ... 24 3) [Tutorial Git] Removendo arquivos do index (área temporária) 4) [Tutorial Git] Enviando arquivos para o repositório Git 5) [Tutorial Git] Corrigindo o último commit no Git 6) [Tutorial Git] Ignorando arquivos no Git 7) [Tutorial Git] Adicionando um arquivo modificado no Git 8) [Tutorial Git] Verificando modificações no repositório 9) [Tutorial Git] Visualizando o commit no modo gráfico 10) [Tutorial Git] Deletando arquivo do repositório 11) [Tutorial Git] Etiquetas 12) [Tutorial Git] O que são branches (ramos) no Git? 13) [Tutorial Git] Visualizando grafo de commits no terminal 14) [Tutorial Git] Renomeando ou movendo arquivos do git 15) [Tutorial Git] Desfazendo commits (checkout) 16) [Tutorial Git] Desfazendo commits (entendendo o reset) 17) [Tutorial Git] Desfazendo commits (revert) 18) [Tutorial] Instalando, configurando e inicializando o Git no Windows 19) [Tutorial Git] Enviando um projeto para o repositório remoto no GitHub 20) [Tutorial Git] Verificando commits remotos 21) [Tutorial Git] Puxando commits remotos 22) [Tutorial Git] Acesso ao Github com SSH 23) [Tutorial Git] Reconfigurando diretório HTTPS para SSH 24) [Tutorial Git] Copiando um repositório existente (git clone) 25) [Tutorial Git] fork: Como colaborar com projetos de código aberto 26) [Tutorial Git] Ver o histórico de commits (git log)

Primeiro é preciso que você tenha uma conta em alguma plataforma de hospedagem de código-fonte que faça uso do Git. Nesse exemplo, usaremos o Github.

Vá até o repositório desejado e procure pelo botão Fork.

botão fork

Ele começará o processo

fazendo fork

E em seguida você será redirecionada para sua conta e poderá notar abaixo do nome do repositório, a origem desse

fork deu certo

Agora precisamos trazer o repositório para a nossa máquina.

No repositório, procure pelo botão clone or download.

clone or download

Copie o link e digite no terminal:

$ git clone link_do_repositorio
  • $ indica que você deve usar o usuário comum para fazer essa operação.

No meu caso, será:

$ git clone git@github.com:danielle8farias/challenges-algorithms.git

Recomenda-se (boas práticas) criar um branch para manter as suas alterações separadas

$ git checkout -b nome_do_novo_branch

Agora você pode alterar o projeto sem qualquer dano ao repositório original.

Depois de feitas todas as alterações necessárias e commits, você provavelmente desejará enviá-las para o seu repositório remoto e para repositório original (já que a sua ideia é contribuir).

Primeiro precisamos verificar nosso repositório remoto

$ git remote -v

Se ele retornar apenas seus repositório, desse modo:

origin  git@github.com:danielle8farias/challenges-algorithms.git (fetch)
origin  git@github.com:danielle8farias/challenges-algorithms.git (push)

Então é preciso adicionar a ligação com o repositório original. Assim:

$ git remote add upstream url_do_repositorio_remoto_original

No meu caso,

$ git remote add upstream git@github.com:WoMakersCode/challenges-algorithms.git

Verificando novamente o repositório remoto

$ git remote -v

temos o retorno algo parecido com

origin  git@github.com:danielle8farias/challenges-algorithms.git (fetch)
origin  git@github.com:danielle8farias/challenges-algorithms.git (push)
upstream    git@github.com:WoMakersCode/challenges-algorithms.git (fetch)
upstream    git@github.com:WoMakersCode/challenges-algorithms.git (push)

Agora, antes de empurrar seu código, é uma boa prática ir até a página do repositório que você está colaborando e clicar na parte de issues para criar um tópico novo (new issue), descrevendo sobre a sua colaboração, quais problemas você pretende solucionar, etc. Ou indo em um tópico já criado para ajudar a solucioná-lo.

issues

Agora, empurre seu código para o seu fork através do comando

$ git push origin nome_do_branch

Feito isso, vá até o seu repositório no Github e perceba que apareceu algo novo:

compare & pull request

Clique sobre ele e abrirá uma nova tela:

criando pull request

Escreva sua mensagem e clique em create pull request.

A mensagem de retorno será algo como

Sucesso

Caso deseje baixar as alterações de um repositório ao qual você fez o fork, clone ou contribuiu, digite:

$ git pull upstream master

git tutorial (26 Part Series)

1) [Tutorial] Instalando, configurando e inicializando o Git no Linux 2) [Tutorial Git] Adicionando arquivos no Git 3 ... 24 3) [Tutorial Git] Removendo arquivos do index (área temporária) 4) [Tutorial Git] Enviando arquivos para o repositório Git 5) [Tutorial Git] Corrigindo o último commit no Git 6) [Tutorial Git] Ignorando arquivos no Git 7) [Tutorial Git] Adicionando um arquivo modificado no Git 8) [Tutorial Git] Verificando modificações no repositório 9) [Tutorial Git] Visualizando o commit no modo gráfico 10) [Tutorial Git] Deletando arquivo do repositório 11) [Tutorial Git] Etiquetas 12) [Tutorial Git] O que são branches (ramos) no Git? 13) [Tutorial Git] Visualizando grafo de commits no terminal 14) [Tutorial Git] Renomeando ou movendo arquivos do git 15) [Tutorial Git] Desfazendo commits (checkout) 16) [Tutorial Git] Desfazendo commits (entendendo o reset) 17) [Tutorial Git] Desfazendo commits (revert) 18) [Tutorial] Instalando, configurando e inicializando o Git no Windows 19) [Tutorial Git] Enviando um projeto para o repositório remoto no GitHub 20) [Tutorial Git] Verificando commits remotos 21) [Tutorial Git] Puxando commits remotos 22) [Tutorial Git] Acesso ao Github com SSH 23) [Tutorial Git] Reconfigurando diretório HTTPS para SSH 24) [Tutorial Git] Copiando um repositório existente (git clone) 25) [Tutorial Git] fork: Como colaborar com projetos de código aberto 26) [Tutorial Git] Ver o histórico de commits (git log)

Posted on by:

danielle8farias profile

ダニエリ

@danielle8farias

Subproduto do Big Bang. Forjada em Supernovas. || Product of the Big Bang, forged in Supernovas.

WoMakersCode

WoMakersCode’s mission is empower women in technology, creating meetups and workshops designed to help you achieve new hard (technical) and soft skills and take the next step in your carrer.

Discussion

markdown guide