Aprender Git é uma habilidade essencial no desenvolvimento de software. A crescente popularidade do software de código aberto levou ao sucesso do Git. Você pode usá-lo para acompanhar as contribuições, gerenciar a colaboração e hospedar bases de código em repositórios remotos.
O Git desempenha um papel vital na maioria dos projetos de código aberto. Descubra qual a relação do Git com o código aberto e como você pode usar essa ferramenta produtiva para potencializar suas contribuições.
A relação entre o Git e o código aberto
Git é um software de controle de versão amplamente utilizado no desenvolvimento. O Git permite rastrear alterações de software em tempo real, salvar cópias de seu código em repositórios remotos e colaborar online. Dê uma olhada em profundidade no Git em nosso tutorial Git avançado.
O Git também é um projeto de código aberto no qual os colaboradores trabalharam para melhorar ao longo do tempo. O software de código aberto geralmente é gratuito para qualquer um usar. O software torna-se de código aberto quando o proprietário concede direitos a qualquer pessoa para usar, alterar e distribuir o código-fonte.
As contribuições de código aberto acontecem de maneira pública e colaborativa, também conhecida como “Building in Public”. Saiba mais sobre a diferença entre software de código aberto e de código fechado.
O Git possui recursos colaborativos que são essenciais em código aberto. O Git permite que as equipes mantenham projetos de forma colaborativa. Ele permite que você busque código, adicione contribuições em sua máquina local e envie suas alterações para revisão.
Recursos do Git usados em código aberto
O Git possui vários comandos usados para realizar operações em sua interface. Existem muitos desses comandos, mas você não precisa aprender todos eles para contribuir com o código aberto. Aqui estão alguns termos e comandos básicos que você encontrará:
- Garfo: Uma cópia de um repositório GitHub (repo). Quando você faz um garfo, você obtém uma cópia dele em sua conta do GitHub, permitindo editar o conteúdo sem afetar o repositório pai do projeto.
- Emitir: Uma ideia, bug ou tarefa na qual os contribuidores podem trabalhar. Um problema com um rótulo como boa primeira edição é uma tarefa simples destinada a motivar os contribuidores a participar de projetos de código aberto.
- Rótulo:Usado para categorizar problemas e discussões.
- Mantenedores: Colaboradores com permissão para modificar os arquivos no repositório de um projeto. Eles também são conhecidos como proprietários de código.
- Contribuintes: Qualquer pessoa que contribui com código, documentação ou outros recursos técnicos para um projeto.
A seguir estão alguns comandos comuns que você usará no desenvolvimento de código aberto:
- Filial: Uma cópia do conteúdo do repositório. Um repositório pode ter várias ramificações: a ramificação principal e várias outras, se necessário. A ramificação padrão é principal/mestre, e você pode nomear ramificações adicionais de acordo com sua finalidade.
- Mesclar:Mesclar significa unir ramificações diferentes de modo que tenham o mesmo código.
- Solicitação de pull (PR): Notifica a manutenção de que você enviou um código que precisa ser revisado. Faça uma solicitação pull quando estiver pronto para mesclar com a ramificação pai e precisar de revisões de outras pessoas.
- Controlo remoto: Versão online do seu repositório local.
- Buscar: Baixa o conteúdo de um repositório remoto em seu repositório local.
- Comprometer-se: Rastreia alterações em um arquivo em um repositório local ou online. Todos os commits têm um ID exclusivo que registra detalhes sobre o autor, hora e natureza das alterações feitas.
Introdução ao Código Aberto
Neste tutorial, veremos as etapas básicas que você seguirá para fazer sua primeira contribuição ao código aberto. Usaremos o Git como repositório local e o GitHub como repositório remoto. Aqui está como você começa.
1. Escolha um projeto
Identifique um projeto adequado para o qual contribuir. Suas habilidades e paixão por fazer a diferença determinarão qual projeto você escolherá. Você pode contribuir com um recurso, documentação ou habilidades, como gerenciamento de produtos.
O projeto certo terá uma comunidade ativa em canais sociais como Slack ou Twitter. Seu repositório deve ter contribuições regulares e licenciamento adequado para software de código aberto.
2. Obtenha o Guia do Colaborador
Todo projeto de código aberto respeitável deve ter um guia de contribuidores. O guia contém instruções e orientações para mostrar aos novos desenvolvedores como contribuir com o projeto.
Você aprenderá como bifurcar, trabalhar em um problema e fazer uma solicitação pull para o repositório upstream para permitir que os mantenedores revisem sua contribuição. Você provavelmente encontrará o guia de contribuidores na pasta raiz do projeto.
O guia do colaborador ajudará você a entender o fluxo de trabalho do projeto e a reduzir os conflitos de mesclagem. Se você não aderir a essas diretrizes de contribuidores, um mantenedor pode rejeitar seu solicitação de pull.
Aqui está um exemplo de um guia de contribuidores do AsyncAPI projeto.
3. Escolha um problema
Um emitir pode ser qualquer coisa para a qual você gostaria de contribuir. Pode ser uma solicitação que você identificou na seção de problemas no repositório do projeto, um erro de digitação ou a documentação que deseja adicionar ao projeto.
Antes de começar a trabalhar em um emitir, primeiro pergunte sobre ou discuta o emitir com os mantenedores. Às vezes, pode ser um problema obsoleto ou no qual outro colaborador já está trabalhando. É assim que a seção de problemas no GitHub se parece:
4. Trabalhe na questão
Depois que os mantenedores aprovarem o problema, você poderá configurar um repositório bifurcado. A bifurcação fornecerá uma cópia do repositório pai para o seu repositório. Você clonará o repositório em sua máquina local com o git clone comando.
Você pode abrir a pasta em seu editor de código preferido e começar a trabalhar. Aqui, é essencial conhecer a sintaxe de linguagens de marcação populares como Markdown, que é popular na maioria dos projetos de código aberto. Se você estiver trabalhando em um problema de documentação, provavelmente usará o Markdown conforme ilustrado abaixo:
5. Envie seu trabalho para revisão
Quando terminar de trabalhar no problema, siga o fluxo de trabalho do guia de contribuidores para enviar seu trabalho ao GitHub para revisão. Use as etapas a seguir para configurar a bifurcação e enviá-la para revisão.
- Conecte seu repositório local ao repositório upstream do projeto usando este comando:
git remote adicionar upstream https://github.com/{original-owner}/{original-repository}.git - Usar git busca para baixar o conteúdo da ramificação upstream para sua ramificação local:
git branch -u upstream/mestre mestre - Crie uma nova ramificação com ramo git . Você pode verificar se a nova ramificação foi criada com ramo git comando.
- Monte sua filial com git add e comprometa-se com git commit -m.
- Envie seu código para a ramificação do GitHub com git push origem .
- faça um solicitação de pull(PR). Um PR alerta os mantenedores para revisar sua ramificação e sugerir mudanças antes da fusão. Este diagrama resume todo o processo.
6. Comentários e fusão
Depois de enviar o PR, os mantenedores provavelmente revisarão e sugerirão mudanças. Você pode fazer alterações locais ou comprometer-se as alterações propostas no repositório remoto. GitHub tem uma provisão para comprometer-se mudanças remotamente.
Durante a avaliação, você receberá feedback sobre sua contribuição e poderá buscar esclarecimentos sobre alguns assuntos. Abaixo está uma ilustração de como você pode fazer alterações no GitHub:
Quando terminar de fazer alterações, faça novos commits. Os commits notificarão os mantenedores para revisar seu trabalho novamente. Se todas as verificações forem aprovadas, seu PR será mesclado rapidamente. Parabéns! Você acabou de fazer sua primeira contribuição para um projeto de código aberto.
Git aprimora a colaboração de código aberto
O Git desempenha um papel essencial nas contribuições de código aberto. O Git permite que projetos grandes e pequenos rastreiem contribuições, gerenciem equipes e hospedem várias versões de códigos-fonte. Como um projeto de código aberto em si, o Git melhorou a qualidade e a quantidade de contribuições para o software de código aberto.
Sua primeira contribuição de código aberto provavelmente será intimidante, mas é fácil e divertida depois que você aprende o fluxo de trabalho. O uso do Git ajudará você a aprimorar suas habilidades de codificação, aprender a colaborar e interagir com as melhores pessoas do setor de tecnologia. Vá em frente e comece!
