11.2 Forks e Pull Requests

Forks e Pull Requests são ferramentas essenciais no GitHub para a colaboração em projetos Open Source. O fork permite criar uma cópia de um repositório para que você possa realizar alterações sem impactar o projeto original, enquanto o Pull Request (PR) serve para sugerir essas modificações ao repositório principal.

Analisando o processo de forma geral, as etapas são as seguintes:

1. Criar um Fork: Crie uma cópia do repositório original na sua conta do GitHub.

2. Clonar o Fork: Clone o seu fork para o seu ambiente local para começar a trabalhar nas alterações.

3. Realizar Alterações Localmente: Realize as alterações necessárias no seu repositório local.

4. Enviar as Alterações para o Fork: Após fazer as modificações, envie as mudanças para o seu repositório remoto (origin) no GitHub.

5. Criar um Pull Request (PR): Abra um Pull Request para sugerir as alterações feitas no seu fork para o repositório original.

Vamos explorar um pouco de cada uma dessas etapas a seguir.

1. Criando um Fork

O primeiro passo é escolher o repositório do qual deseja fazer um fork.

Acesse a página do repositório no GitHub e clique no botão Fork. Isso criará uma cópia do repositório original na sua conta, permitindo que você faça modificações sem alterar o projeto principal.

2. Clonando o Fork

Pensando da perspectiva do seu fork, a nomenclatura utilizada é:

• origin → seu repositório (fork)

• upstream → o repositório original

Para sugerir mudanças no upstream, primeiro é necessário clonar o seu fork localmente. Execute o comando git clone repositório.

O GitHub enviará uma cópia do seu origin para seu computador.

Essa cópia será armazenada automaticamente no seu ambiente local.

Agora, você tem uma versão local do repositório e pode começar a fazer alterações.

3. Realizar Alterações Localmente

Edite os arquivos conforme necessário e salve as mudanças.

Em seguida, envie essas alterações para o seu repositório remoto (origin) no GitHub.

4. Criando um Pull Request

Assim que suas mudanças estiverem disponíveis no GitHub no seu repositório (origin), você poderá abrir um Pull Request (PR) para sugerir essas alterações ao repositório original (upstream).

Se o PR for aprovado pelas pessoas mantenedoras do repositório original, suas modificações serão incorporadas ao branch principal do upstream.

A seguir, veremos como realizar esse processo na prática, passo a passo.