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
Bifurcando um repositório em a plataforma GitHub cria uma cópia - também conhecida como "bifurcação" - desse repositório, em 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 garfo botão no canto superior direito:
Preencha o nome do repositório (fork) e uma descrição opcional e clique em Criar bifurcação:
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, pode 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
Substituir com o 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 Git.
Etapa 3: abrindo uma solicitação pull
Depois de fazer o commit de suas alterações no GitHub, você deverá 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 Contribuir suspenso. Clicar neste botão solicitará que você abra uma solicitação pull. Em seguida, clique no Solicitação de pull aberta botão:
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 Criar solicitação de recebimento botão:
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.