image

Acesse bootcamps ilimitados e +650 cursos

50
%OFF
Article image
Hercules Lima
Hercules Lima27/07/2023 00:44
Compartilhe

Como Contribuir em um Projeto Open Source no GitHub

    Uma das recomendações fundamentais que costumamos receber ao iniciar nossa jornada como programadores é a de engajar-nos em projetos de código aberto ou open source. Participar desses projetos oferece diversas vantagens, como adquirir experiência (ao ler, criar e modificar códigos), conquistar reconhecimento na comunidade e abrir portas para novas oportunidades profissionais.

    Entretanto, você pode estar se perguntando como exatamente funciona o processo de contribuição para um projeto desse tipo no GitHub. Vou explicar esse fluxo de forma mais detalhada:

    1) Encontrar um projeto Open Source para contribuir 

    Pode-se utilizar a busca do GitHub para encontrar projetos na tecnologia que você gostaria de praticar.

    2) Ler a documentação do projeto

    O arquivo detalhará como funciona a contribuição para o projeto, explicando todas os procedimentos que você deverá seguir para fazer a sua contribuição.

    3) Acessar a aba Issues

    Procurar por alguma issue que já foi aberta e que não tem ninguém trabalhando ou abrir uma issue. A abertura de uma issue é uma sugestão no projeto e o manteie do projeto irá avaliar se a sua sugestão é válida ou não. O manteie aprovando, você estará apto para prosseguir.

    4) Fork

    O próximo passo é realizar um fork do repositório do projeto no GitHub.

    5) Clonar

    Feito o fork do repositório, será criado um novo repositório no seu perfil do GitHub. Faça um git clone deste na sua máquina (seu ambiente local).

    6) Adicionando um repositório remoto e atualizando seu repositório local em relação ao remoto

    Neste passo é preciso que você crie um novo repositório remoto (que será o repositório original do projeto).

    git remote add origin urlDoRepositórioDoProjeto
    
    

    No caso, chamei o novo repositório remoto de origin, mas você pode colocar o nome que preferir. Ao realizar o comando abaixo, irei atualizar meu repositório local em relação ao repositório remoto (branch main ou master - a depender de como está nomeada a branch principal do repositório que você fez o fork).

    git pull upstream principal
    
    

    7) Criar uma nova branch

    Feito isso, deve-se criar uma branch para que você possa fazer as alterações/criações de código necessárias

    git checkout -b newBranch
    
    

    8) Faça/modifique o código

    9) Realizar Stage - Commit do seu trabalho

    10) Abra uma solicitação pull

    Abra pull request solicitando o merge da branch que você criou (novoBranch) ao repositório do projeto Open Source no qual deseja contribuir.

    Lembre-se de referenciar na pull request qual issue você está solucionando.

    Compartilhe
    Comentários (2)
    Adriely Castro
    Adriely Castro - 27/07/2023 10:10

    Muito útil

    Savio Sayanne
    Savio Sayanne - 27/07/2023 08:28

    Excelente Post.