Junte-se à tendência de codificação social e contribua com os repositórios GitHub

Você já encontrou um pacote no GitHub de que gostou, mas queria adicionar um recurso rápido, corrigir um bug que encontrou ou talvez apenas contribuir para o código aberto como um todo? Junte-se à tendência da codificação social, compartilhe suas habilidades e ajude a beneficiar o mundo do código aberto. Neste artigo, aprenda tudo sobre como contribuir com código para um repositório no GitHub ou qualquer serviço git hospedado.

Obter configuração

Este artigo presume que você já tem uma conta no GitHub, mas se não tiver, registre – se rapidamente para obter uma conta gratuita . Além disso, verifique se você já instalou o git executando o seguinte comando no terminal:

 git --version

Se, em vez de ver o número da versão, você receber uma mensagem "comando não encontrado", pode instalar o git com o comando:

 sudo apt-get -y install git

Bifurcação do Repositório

Primeiro você deve escolher o repositório com o qual deseja contribuir e visitá-lo em seu navegador. Se não tiver certeza de qual repositório escolher, você pode usar o repositório de demonstração localizado em https://github.com/mdizak/muo_demo . Esta é uma demonstração simples e você está convidado a criar solicitações pull para fins de teste e aprendizado.

Ao visualizar o repositório em seu navegador da web, procure o botão Repositório Fork e clique nele. Isso bifurcará o repositório para sua própria conta do GitHub e o levará até ele. Em seguida, você precisa clonar o repositório recém-bifurcado , então abra o terminal em seu computador local e execute:

 git clone https://github.com/myusername/muo_demo.git
 cd muo_demo

Naturalmente, certifique-se de alterar a URL acima para a do seu repositório recém-bifurcado. Depois de clonado, adicione o repositório original como um upstream com o comando:

 git remote add upstream https://github.com/mdizak/muo_demo.git

Certifique-se de alterar a URL no comando acima com aquela do repositório original que você clonou. Isso significa git que é um repositório pai no qual você está trabalhando.

Prepare Repositório Local

Toda vez, antes de começar a trabalhar em uma nova contribuição, certifique-se de que está executando a base de código mais recente do repositório pai. Dentro do diretório do projeto, execute os seguintes comandos no terminal:

 git checkout master
 git pull upstream master && git push origin master

O primeiro comando garante que você esteja trabalhando atualmente no branch master, e o segundo comando sincroniza o repositório pai com seus repositórios local e GitHub. Isso garante que você está modificando a base de código mais atualizada e não está trabalhando com código desatualizado.

Certifique-se também de verificar se o projeto tem um arquivo contrib.md e, em caso afirmativo, siga o que ele diz. Às vezes, os projetos têm diretrizes específicas sobre como fazer contribuições, que devem ser sempre seguidas.

Criar uma nova filial

Você precisa criar um novo branch que conterá todas as modificações para esta contribuição, que mais tarde será mesclada no repositório principal do GitHub pelos mantenedores do projeto. A ramificação deve ser alfanumérica e pode receber qualquer nome que você desejar.

Embora não seja obrigatório, geralmente é considerado uma cortesia comum prefixar o nome do branch com hotfix / para soluções rápidas de bugs ou recursos / para recursos adicionais. Escolha o nome do branch desejado e execute o comando:

 git checkout -b feature/my_cool_feature

Você deve sempre criar um branch separado para cada correção de recurso / bug e nunca incluir várias contribuições em uma. Isso ajuda a manter um fluxo de desenvolvimento tranquilo e também ajuda a garantir que sua contribuição seja aceita e incluída no projeto.

Agora que seu branch foi criado, vá em frente e conclua todas as modificações necessárias que você gostaria com o fluxo de trabalho padrão do git.

Commit e criar solicitação pull

Depois de concluir o trabalho em sua contribuição, envie-a com uma mensagem de confirmação adequada e envie-a para seu repositório bifurcado com os comandos:

 git commit --file commit.txt
 git push -u origin feature/my_cool_feature

A última etapa é criar uma solicitação pull alertando os mantenedores do projeto que uma nova contribuição está pendente. Visite o repositório bifurcado do GitHub em seu navegador da web e você verá um botão suspenso que permite alterar os branches. Mude para seu branch recém-criado e a próxima página conterá um link que permite criar uma nova solicitação pull.

Ao clicar nesse link, você verá uma página que mostra sua mensagem de commit, e todas as alterações que você fez no código. Revise tudo para garantir que está correto, adicione qualquer mensagem adicional necessária para os mantenedores e envie a solicitação de pull.

Continue contribuindo com o GitHub

Parabéns, você enviou com sucesso uma contribuição para um projeto GitHub!

Sua solicitação pull agora está aguardando revisão e aprovação pelos mantenedores do projeto, e você será notificado por e-mail se foi ou não aprovado, e com quaisquer mensagens que eles tenham para você. Agora que você aprendeu como contribuir com projetos no GitHub, continue avançando e ajude a expandir a comunidade de código aberto .