Sobre bifurcações
Um fork é um novo repositório que compartilha configurações de código e visibilidade com o repositório "upstream" original. Os forks geralmente são usados para iterar ideias ou alterações antes de serem propostas de volta para o repositório upstream, como em projetos código aberto ou quando um usuário não tem acesso de gravação ao repositório upstream. Para saber mais, confira Trabalhar com bifurcações.
Proponha mudanças no projeto de outra pessoa
Por exemplo, você pode usar bifurcações para propor alterações relacionadas à correção de um bug. Em vez de registrar um erro encontrado, você pode:
- Crie fork do repositório.
- Fazer a correção.
- Enviar uma pull request ao proprietário do projeto.
Use o projeto de outra pessoa como ponto de partida para sua própria ideia.
O software de código aberto baseia-se na ideia de que ao compartilhar códigos, podemos criar softwares melhores e mais confiáveis. Para obter mais informações, confira Sobre a Open Source Initiative na Open Source Initiative.
Para obter mais informações sobre como aplicar os princípios de código aberto ao trabalho de desenvolvimento da sua organização, em GitHub confira o white paper, do GitHub, Uma introdução ao InnerSource.
Ao criar um repositório público a partir de uma bifurcação do projeto de outra pessoa, confirme que incluiu um arquivo de licença que estabelece como você quer que seu projeto seja compartilhado com outros. Para obter mais informações, confira Escolher uma licença de código aberto em choosealicense.com.
Para obter mais informações sobre código aberto, especificamente como criar e expandir um projeto de código aberto, criamos os Guias de Código Aberto, que ajudarão você a promover uma comunidade de código aberto benéfica, recomendando melhores práticas para criar e manter repositórios no seu projeto de código aberto. Você também pode fazer um curso gratuito de GitHub Skills sobre como manter comunidades de código aberto.
Pré-requisitos
Se ainda não tiver feito isso, primeiro configure o Git e a autenticação com sua instância do GitHub Enterprise Server do Git. Para saber mais, confira Configurar o git.
Bifurcar um repositório
É possível criar fork do repositório noGitHub.com ou no GitHub Desktop. Para obter informações sobre a bifurcação no GitHub.com, confira a versão do navegador da Web deste artigo.
No GitHub Desktop, se você clonar um repositório ao qual não tem acesso de gravação e, em seguida, tentar efetuar push de uma alteração para o repositório, um fork será criado para você.
-
No menu Arquivo, clique em Clonar Repositório.
-
Clique na aba que corresponde à localização do repositório que você deseja clonar. Neste exemplo, clicamos na guia URL.
-
Insira a URL ou o caminho do repositório que deseja clonar.
-
Para selecionar o diretório local no qual você deseja clonar o repositório, ao lado do campo "Caminho Local", clique em Escolher... e navegue até o diretório.
-
Na parte inferior da janela "Clonar um Repositório", clique em Clonar.
-
Para criar um fork, tente efetuar push de uma alteração para o repositório. Em seguida, crie um branch e publique-o. Um prompt será exibido perguntando se você deseja criar fork desse repositório.
-
Leia as informações em "Como você está planejando usar essa bifurcação?" .
- Se você pretende usar esse fork para contribuir com o repositório upstream original, clique em Para contribuir com o projeto pai.
- Se você pretende usar esse fork para um projeto não conectado ao upstream, clique em Para minhas próprias finalidades.
-
Clique em Continuar.
Configurar o Git para sincronizar o fork com o repositório upstream
Ao criar fork em um projeto para propor mudanças no repositório original, é possível configurar o Git para fazer pull de alterações do repositório upstream no clone local do fork.
Editando uma bifurcação
Você pode fazer alterações em uma bifurcação, incluindo:
- Como criar branches: os branches permitem que você crie recursos ou teste ideias sem colocar seu projeto principal em risco.
- Como abrir solicitações de pull: se você deseja contribuir novamente para o repositório upstream, envie uma solicitação ao autor original para efetuar pull do fork no repositório enviando uma solicitação de pull.
Localize outro repositório para bifurcar
Bifurque um repositório para começar a contribuir com um projeto. Você poderá criar forks de um repositório privado ou interno para sua conta pessoal ou para uma organização em GitHub, no qual você tem permissão para criar repositórios, contanto que as configurações do repositório e as políticas corporativas permitam a criação de forks. Em geral, você pode criar fork em qualquer repositório público para sua conta pessoal ou para uma organização em que tenha permissão para criar repositórios.
Para saber mais sobre quando você pode criar fork de um repositório, confira Sobre permissões e visibilidade de bifurcações.
Próximas etapas
Você já bifurcou um repositório, treinou clonar sua bifurcação e configurou um repositório upstream.
-
Para saber mais sobre como clonar o fork e sincronizar as alterações em um repositório com fork usando o seu computador, confira Configurar o git.
-
Você também pode criar um novo repositório onde você pode colocar todos os seus projetos e compartilhar o código em GitHub. A criação de um repositório para seu projeto permite que você armazene código no GitHub. Isso fornece um backup do seu trabalho que você pode optar por compartilhar com outros desenvolvedores. Para saber mais, confira Início rápido para repositórios.
-
Cada repositório do GitHub pertence a uma pessoa ou organização. Você pode interagir com as pessoas, os repositórios e as organizações conectando-se e seguindo-as no GitHub. Para saber mais, confira Encontrando inspiração no GitHub.
-
O GitHub tem uma ótima comunidade de suporte na qual você pode pedir ajuda e conversar com pessoas de todo o mundo. Participe da conversa na GitHub Community.