Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Contribuir para projetos

Aprenda a contribuir para um projeto por meio da bifurcação.

Members of an enterprise with managed users cannot fork repositories from outside of the enterprise or fork internal repositories.

Sobre a bifurcação

Depois de usar o GitHub por um tempo, você deverá contribuir para o projeto de outra pessoa. Ou talvez você deva usar o projeto de alguém como ponto de partida para o seu próprio projeto. Este processo é conhecido como bifurcação.

A criação de uma "bifurcação" produz uma cópia pessoal do projeto de outra pessoa. As bifurcações atuam como um tipo de ponte entre o repositório original e a sua cópia pessoal. Você pode enviar pull requests para ajudar a melhorar os projetos de outras pessoas oferecendo suas alterações até o projeto original. A bifurcação é um elemento essencial do código social no GitHub. Para obter mais informações, consulte "Bifurcar um repositório".

Bifurcar um repositório

Este tutorial usa o projeto Spoon-Knife, um repositório de teste hospedado em GitHub.com que permite testar o fluxo de trabalho de bifurcação e pull request.

  1. Acecsse o projeto Spoon-Knife em https://github.com/octocat/Spoon-Knife.
  2. Clique em Bifurcação. Botão Fork (Bifurcação)
  3. GitHub Enterprise Cloud irá direcionar você para sua cópia (sua bifurcação) do repositório Spoon-Knife.

Clonando uma bifurcação

Você criou com sucesso o repositório Spoon-Knife mas, até agora, ele existe apenas em GitHub Enterprise Cloud. Para poder trabalhar no projeto, você deverá cloná-lo para o seu computador.

Você pode clonar a sua bifurcação com a linha de comando, GitHub CLI ou GitHub Desktop.

  1. Em GitHub Enterprise Cloud, vá até your fork (sua bifurcação) no repositório Spoon-Knife.

  2. Acima da lista de arquivos, clique em código. Botão de "Código"

  3. Copy the URL for the repository.

    • To clone the repository using HTTPS, under "HTTPS", click .
    • Para clonar o repositório usando uma chave SSH, incluindo um certificado emitido pela autoridade de certificação SSH da sua organização, clique em SSH e, em seguida, clique em .
    • To clone a repository using GitHub CLI, click GitHub CLI, then click . O ícone da área de transferência para copiar a URL para clonar um repositório com o CLI do GitHub
  4. Abra TerminalTerminalGit Bash.

  5. Altere o diretório de trabalho atual para o local em que deseja ter o diretório clonado.

  6. Digite git clone (clonar git) e cole a URL que você copiou anteriormente. Ficará assim, com seu GitHub Enterprise Cloud nome de usuário no lugar de YOUR-USERNAME:

    $ git clone https://github.com/YOUR-USERNAME/Spoon-Knife
  7. Pressione Enter. Seu clone local estará criado.

    $ git clone https://github.com/YOUR-USERNAME/Spoon-Knife
    > Clonando para `Spoon-Knife`...
    > remote: Contando objetos: 10, concluído.
    > remote: Compactando objetos: 100% (8/8), concluído.
    > remove: Total 10 (delta 1), reused 10 (delta 1)
    > Unpacking objects: 100% (10/10), done.

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

Para criar um clone da sua bifurcação, use o sinalizador --clone.

gh repo fork repository --clone=true
  1. No menu File (Arquivo), clique em Clone Repository (Clonar repositório).

    Opção de menu Clone (Clonar) no app Mac

    Opção de menu Clone (Clonar) no app Windows

  2. Clique na aba que corresponde à localização do repositório que você deseja clonar. Você também pode clicar URL para inserir manualmente o local do repositório.

    Guias Location (Local) no menu Clone a repository (Clonar um repositório)

    Guias Location (Local) no menu Clone a repository (Clonar um repositório)

  3. Escolha o repositório que você quer clonar na lista.

    Clonar uma lista de repositórios

    Clonar uma lista de repositórios

  4. Clique em Escolher... e acesse um caminho local onde você deseja clonar o repositório.

    Botão Choose (Escolher)

    Botão Choose (Escolher)

  5. Clique em Clone (Clonar).

    Botão Clone (Clonar)

    Botão Clone (Clonar)

Fazendo e enviando por push as alterações

Siga em frente e faça algumas alterações no projeto usando o seu editor de texto favorito, como Atom. Você pode, por exemplo, alterar o texto em index.html para adicionar o seu nome de usuário do GitHub.

Quando estiver pronto para enviar suas alterações, teste e faça commit das suas alterações. git add . informa ao Git que você deseja incluir todas as alterações no próximo commit. git commit tira um instantâneo dessas alterações.

git add .
git commit -m "Uma breve descrição da alteração"
git add .
git commit -m "Uma breve descrição da alteração"

Para obter mais informações sobre como testar e fazer commit das alterações em GitHub Desktop, consulte "Fazendo commit e revisando as alterações no seu projeto."

Ao testar e fazer commit dos arquivos, você essencialmente diz ao Git, "Ok, tire um instantâneo das minhas alterações!" Você pode continuar fazendo mais alterações e tirar mais instantâneos do commit.

No momento, suas alterações existem apenas localmente. Quando estiver pronto para fazer push das suas alterações para GitHub Enterprise Cloud, faça push delas para o controle remoto.

git push
git push

Para obter mais informações sobre como fazer push de alterações em GitHub Desktop, consulte "Envio por push das alterações para o GitHub."

Fazendo um pull request

Finalmente, você está pronto para propor alterações no projeto principal! Essa é a última etapa para produzir uma bifurcação do projeto de outra pessoa, e a mais importante, indiscutivelmente. Se você fez uma alteração que você considera que beneficiaria a comunidade como um todo, você deve considerar contribuir de novamente.

Para fazer isso, acesse o repositório GitHub Enterprise Cloud onde seu projeto encontra-se. Para este exemplo, ela seria em https://www.github.com/<your_username>/Spoon-Knife. Você verá um banner que indica que o seu branch é um commit à frente do octocat: main. Clique em Contribuir e, em seguida, Abrir um pull request.

O GitHub Enterprise Cloud levará você a uma página que mostra as diferenças entre a sua bifurcação e o repositório octocat/Spoon-Knife. Clique em Create pull request (Criar pull request).

GitHub Enterprise Cloud levará você a uma página onde você pode inserir um título e uma descrição das suas alterações. É importante fornecer tantas informações úteis e uma razão para o motivo de você estar fazendo este pull request. O proprietário do projeto deve poder determinar se a sua alteração é tão útil para todos quanto você pensa. Por fim, clique em Criar pull request.

Gerenciando feedback

Os pull requests são uma área de discussão. Neste caso, o Octocat está muito ocupado e provavelmente não irá fazer merge das suas alterações. Para outros projetos, não se ofenda se o proprietário do projeto rejeitar o seu pull request ou pedir mais informações sobre o porquê de a alteração ter sido feita. Pode até ser que o proprietário do projeto não faça o merge do seu pull request e isso está perfeitamente bem. Your copy will exist in infamy on the Internet. E quem sabe - talvez alguém que você nunca conheceu, considere as suas alterações muito mais valiosas do que o projeto original.

Encontrando projetos

Você fez uma bifurcação com sucesso e contribuiu de volta para um repositório. Vá em frente e contribua com um pouco mais!