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 com 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 pressupõe que você já tenha uma conta GitHub, mas se não tiver, rapidamente Cadastre-se para criar uma conta gratuita. Além disso, verifique se você já tem idiota instalado executando o seguinte comando no terminal:

git --version

Se ao invés de ver o número da versão você receber uma mensagem "comando não encontrado", você pode instalar idiota 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ê pode criar solicitações pull para fins de teste e aprendizado.

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

Como clonar um repositório usando o GitHub Desktop

Quer se familiarizar com o software no GitHub? Veja como fazer isso com a ferramenta GitHub Desktop simplificada.

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 que é um repositório pai no qual você está trabalhando.

Prepare Repositório Local

Sempre que você 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. No 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.

Além disso, certifique-se 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 recurso/ 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, comprometa-a com um mensagem de confirmação adequada e envie-o 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 mudanças 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 o comunidade de código aberto.

Como adicionar mais RAM ao seu dispositivo Android com um cartão MicroSD

Se o seu telefone ou tablet Android estiver um pouco lento, talvez precise de um pouco mais de RAM. Nós podemos ajudar com isso.

Sobre o autor