Como abrir uma solicitação pull no GitHub

Um pull request (PR) é um recurso do GitHub que permite propor alterações em um repositório ao qual você não tem acesso de gravação. Os mantenedores do repositório podem revisar essas alterações e, se quiserem, mesclá-las no repositório original.

Abrir solicitações pull no GitHub é crucial para contribuir com projetos de código aberto e colaborar com outros desenvolvedores. Aprenda a criar e abrir uma solicitação pull no GitHub em apenas algumas etapas fáceis.

Etapa 1: bifurcando o repositório

Bifurcar um repositório na plataforma GitHub cria uma cópia — também conhecida como “bifurcação” — desse repositório, na sua conta. Bifurcar um repositório permite que você faça alterações no código sem afetar o repositório original.

Para bifurcar um repositório, navegue até sua página principal e clique no botão bifurcar no canto superior direito:

Preencha o nome do repositório (fork) e uma descrição opcional e clique em Create fork :

Agora você criou uma cópia do repositório original. Este novo repositório tem uma conexão com o original para que quaisquer alterações feitas no código possam ser facilmente comparadas e mescladas novamente nele.

Etapa 2: fazer alterações no código

Depois de bifurcar o repositório, pode ser necessário cloná-lo em sua máquina local, dependendo da quantidade e natureza das alterações que deseja propor. Se você estiver fazendo alterações muito simples que não precisa testar, poderá fazê-lo online usando o editor baseado na Web do GitHub .

Para clonar um repositório em sua máquina local usando o Git, execute este comando de terminal:

git clone <REPOSITORY_URL>


Substitua <REPOSITORY_URL> pelo URL do seu repositório — você pode encontrá-lo no GitHub. Este comando irá clonar o repositório para sua máquina local, onde você pode experimentar livremente e fazer alterações no código.

Você deve manter suas alterações pequenas e focadas, pois grandes solicitações pull podem ser difíceis de revisar e mesclar. Tente manter suas alterações específicas para um problema ou recurso, para tornar mais fácil para os mantenedores revisá-las e aceitá-las.

Depois de fazer as alterações desejadas localmente, confirme-as e envie-as para o fork do GitHub usando o Git.

Etapa 3: abrindo uma solicitação pull

Depois de fazer o commit de suas alterações no GitHub, você deve ver um prompt alertando que seu branch está um número de “commits” à frente do repositório do qual você o bifurcou, por exemplo:

Clique no menu suspenso Contribuir . Clicar neste botão solicitará que você abra uma solicitação pull. Em seguida, clique no botão Open pull request :

Alguns repositórios têm diretrizes de contribuição específicas, que normalmente você pode encontrar em um arquivo CONTRIBUTING.md, que você precisa seguir. Certifique-se de ler e seguir estas diretrizes antes de enviar uma solicitação pull.

Em seguida, preencha os campos obrigatórios e clique no botão Create pull request :

Sua mensagem de commit deve ser clara e concisa, descrevendo as mudanças que você fez e o raciocínio por trás delas. Isso ajudará os mantenedores a entender suas alterações e facilitará a revisão do código.

Depois de criar seu pull, você precisará aguardar que os mantenedores do projeto revisem e mesclem ou fechem. Os mantenedores podem ter sugestões ou comentários sobre sua solicitação pull. Esteja aberto a mudanças e disposto a fazer revisões se eles pedirem.

A importância das solicitações pull

As solicitações pull facilitam a colaboração entre os desenvolvedores, permitindo que eles proponham alterações, forneçam feedback e revisem o código. Isso ajuda a promover um senso de comunidade e colaboração dentro de um projeto, levando a mais contribuições e desenvolvimento mais rápido.

Além disso, as solicitações pull organizam o histórico e o controle de versão do projeto, permitindo que os mantenedores acompanhem as diferentes versões do código e as alterações feitas em cada versão.