Então você se deparou com um projeto no GitHub e gostaria de contribuir para esse projeto. Mas como? Você não se considera um desenvolvedor e a terminologia de controle de origem é estranha para você. Sem problemas. A resposta é uma solicitação de pull (PR) do Git.
Neste tutorial, você aprenderá como contribuir para um projeto do GitHub com uma solicitação de pull do Git para inserir seu código em um repositório do GitHub (repo).
Contribuindo para um Projeto do GitHub
Neste ponto, você provavelmente já viu pelo menos um projeto do GitHub onde sente que poderia ajudar a corrigir alguns bugs, atualizar alguma documentação ou adicionar um novo recurso. Você quer se envolver, mas, como muitos outros profissionais de TI, você não se considera um desenvolvedor de software.
O Git e o GitHub tradicionalmente estiveram firmemente no espaço de desenvolvimento. Mas, com cada vez mais infraestrutura migrando para a nuvem e com o surgimento de ferramentas de Infraestrutura como Código, os administradores de sistemas têm explorado mais o GitHub.
Muitos profissionais de TI não sabem por onde começar. Então, neste artigo, você vai aprender desde o início como contribuir com código para um projeto do GitHub existente com solicitações de pull.
O que é uma Solicitação de Pull?
Quando você tem um código/correção que adicionará mais funcionalidade ou dará mais valor a um projeto ou repositório existente no GitHub, você pode criar uma solicitação de pull.
Mesmo que um pull request seja uma única ação, o resultado final (colocar seu código no repositório GitHub de outra pessoa) envolve cinco estágios aproximados que você aprenderá neste tutorial.
1. Forking ou “copiando” o repositório original para sua conta do GitHub
O termo “forking” às vezes é confundido com o termo “cloning”. Git e GitHub são dois produtos separados. “Forking” é um termo do GitHub que cria uma réplica de um repositório do GitHub no GitHub. “Cloning” é um termo do Git que se refere à criação de um repositório Git local em seu computador baixando um repositório Git remoto.
2. Committing código para nosso repositório forked pessoal e pushing esse código para o repositório GitHub
3. Enviando um pull request para o proprietário do repositório
4. Proprietário do repositório revisando e aprovando suas mudanças no pull request
5. Proprietário do repositório mesclando suas mudanças na branch principal
Pré-requisitos
Para acompanhar as demonstrações neste tutorial, certifique-se de ter o seguinte:
- A GitHub account
- A GitHub repo to request changes to – This tutorial will use a repo called git-pull-requests.
- Git – Este tutorial usará o Git no Windows em um diretório de trabalho de C:\Git.
- Git configurado para funcionar com a sua conta do GitHub
Fazendo o Fork do Repositório no GitHub
Como não é possível fazer alterações diretas no repositório GitHub de outra pessoa, você primeiro precisa criar o seu próprio. Para fazer isso, você precisa fazer um fork ou criar uma cópia do repositório na sua própria conta do GitHub. Para isso:
1. Abra o seu navegador da web favorito, vá para GitHub e faça login.
2. Vá para o repositório do tutorial ou o repositório ao qual você gostaria de contribuir, como mostrado abaixo.
3. No canto superior direito, clique no botão Fork. Esse botão criará automaticamente uma cópia desse repositório na sua conta.
Uma vez feito o fork, agora você deverá ver o mesmo repositório na lista dos seus repositórios. Você também pode ver abaixo que este repositório foi fazido fork de Adam-the-Automator\git-pull-requests.
Commitando Novo Código no Seu Fork Pessoal
Agora que você tem sua própria cópia pessoal do repositório na sua conta do GitHub, é hora de fazer as suas alterações. Você pode fazer alterações no código de um repositório GitHub de duas maneiras: diretamente através de github.com ou localmente via Git. Vamos abordar ambas as formas.
Commitando Código via github.com
A maneira mais fácil de fazer alterações no código em um repositório GitHub é simplesmente usar o navegador da web. Ao usar o github.com, você não precisa se preocupar em configurar qualquer tipo de software localmente. No entanto, usar o navegador da web logo se tornará uma dor de cabeça se você precisar fazer qualquer alteração moderadamente complexa.
Supondo que você ainda esteja visualizando o repositório forkado em seu navegador:
1. Clique no script SampleText.ps1 em seu repositório forkado e clique no ícone do lápis para editá-lo.
2. Faça alterações no arquivo e clique no botão Commit changes conforme mostrado abaixo, opcionalmente adicionando uma mensagem de commit.
Commitando Código via Git
Se você planeja fazer mais de uma alteração simples em um arquivo no repositório GitHub, você deve usar o Git. O Git permite que você clone o repositório inteiro para o seu computador local e trabalhe no código em seu editor de código favorito.
Clonando
Para trabalhar no código do repositório forkado localmente, você primeiro precisará clonar o repositório inteiro para o seu computador local com o Git. Para fazer isso:
Supondo que você ainda esteja em seu repositório forkado em github.com:
1. Clique no botão Code e copie a URL sob a seção HTTPS.
2. Em seguida, abra um console de linha de comando em seu computador. Este tutorial usará o Windows PowerShell.
3. Crie um diretório para armazenar o repositório clonado e execute git clone apontando para a URL copiada no passo anterior.
Commitando e Enviando Arquivos Locais
Depois de clonar o repositório Git, é hora de alterar o arquivo e fazer commit dessas alterações no repositório. Para fazer isso:
1. Abra seu editor de código favorito, edite e salve o script C:\SampleText.ps1.
2. Na janela do terminal, verifique se seu diretório de trabalho é C:\Git e execute o comando abaixo. O comando git add adiciona o arquivo ao repositório Git local, mas não o salva. Ele simplesmente começa a rastreá-lo.
3. Em seguida, faça commit ou salve todos os arquivos rastreados no repositório Git com o comando git commit. Certifique-se também de incluir uma explicação do que foi alterado (mensagem de commit) com o parâmetro -m.
4. Agora que o repositório Git local contém o arquivo alterado, envie essa alteração para o repositório GitHub com o comando git push. Você deverá receber uma caixa solicitando que você forneça seu nome de usuário e senha do GitHub para autenticar-se no seu repositório GitHub clonado.
5. Depois de fornecer seu nome de usuário e senha do GitHub, você deverá ver o Git fornecer algumas informações de status como abaixo.
Enviando um Pedido de Pull
Neste momento, você já possui uma cópia do repositório do GitHub para o qual deseja contribuir (forked) em sua própria conta do GitHub, com a alteração que gostaria de solicitar ao proprietário do repositório do GitHub. É hora de enviar uma solicitação pull para pedir ao proprietário que aceite sua alteração.
1. Navegue até seu repositório forked no GitHub.
2. Clique em Pull Requests e em Nova solicitação pull como mostrado abaixo.
3. Na página de solicitação pull, você verá os dois repositórios que serão comparados e cada commit que está solicitando mesclar no repositório do GitHub do proprietário. Clique em Criar solicitação pull.
4. Forneça um título para a solicitação pull e clique em Criar solicitação pull.
Em seguida, você verá no repositório original do GitHub, uma solicitação pull será exibida. Neste momento, seu trabalho está feito e é hora de esperar pelo proprietário.
Revisando e Aceitando uma Solicitação Pull
Assim que você criar uma solicitação pull, ela aparecerá em Solicitações pull sob o repositório original do GitHub, como mostrado abaixo.
Neste ponto, o proprietário agora poderá fornecer comentários a você, onde você pode colaborar na solicitação pull. Ou, eles podem simplesmente mesclar imediatamente clicando em Mesclar solicitação pull.
Uma vez que eles mesclarem a solicitação pull com o código original, a solicitação pull entrará em status Mesclada e o código será mesclado com o repositório original!
Agora, você pode ver que é um contribuinte para o arquivo que você alterou e foi mesclado.
Conclusão
Neste tutorial, aprendeu cada passo sobre como criar um pedido de pull no Git. Os pedidos de pull são uma ótima maneira de colaborar em repositórios do GitHub.
Agora que sabe como contribuir para projetos do GitHub, qual será o próximo repositório em que contribuirá?