O Pull Request (PR) é o coração da colaboração no desenvolvimento de software. Ele é o mecanismo que permite que você proponha alterações em um repositório, receba feedback, discuta mudanças e, finalmente, mescle seu código ao projeto principal.

O Passo a Passo do Fluxo de Trabalho Link para o cabeçalho

  1. Fork ou Clone: Tenha uma cópia do projeto no seu ambiente.

  2. Crie uma Branch: Nunca trabalhe diretamente na branch principal (main ou master). Crie uma branch dedicada à sua funcionalidade ou correção.

  • git checkout -b nome-da-sua-feature

  1. Faça suas alterações: Escreva seu código, teste e salve as alterações.

  2. Commit e Push: Envie suas mudanças para o repositório remoto.

  • git commit -m "Descrição clara da mudança"
  • git push origin nome-da-sua-feature
  1. Abra o Pull Request: No site do GitHub, navegue até o repositório e clique no botão “Compare & pull request”.

Cenário de Exemplo: “O Botão de Cor do Site” Link para o cabeçalho

Imagine que você está colaborando no projeto de um site chamado TechStore.

O Contexto Link para o cabeçalho

O mantenedor do projeto abriu uma Issue solicitando: “Mudar a cor do botão ‘Comprar’ de cinza para verde para melhorar a conversão.”

A Execução Link para o cabeçalho

  1. Preparação: Você cria uma branch chamada fix-button-color.

  2. Mudança: Você altera o código CSS do botão no seu editor.

  3. Envio: Você faz o commit com a mensagem “Altera cor do botão comprar para verde” e faz o push para o GitHub.

  4. Abertura do PR:

  • Você vai ao site do GitHub. O sistema detecta que você subiu uma branch nova e exibe o botão “Compare & pull request”.
  • Você escreve uma descrição: “Este PR altera a cor do botão de compra para verde, conforme solicitado na Issue #12, para aumentar o destaque visual.”

  1. Discussão: O mantenedor revisa seu código, sugere um tom de verde mais claro, você faz o ajuste, envia um novo commit na mesma branch e o PR é atualizado automaticamente.

  2. Merge: Após a aprovação, o mantenedor clica em “Merge pull request”. Seu código agora faz parte da versão principal do site!

Dicas para um PR de sucesso Link para o cabeçalho

  • Seja descritivo: Explique por que você fez a mudança, não apenas o que mudou.

  • Mantenha o foco: Um PR deve resolver apenas um problema. Não misture uma correção de bug com a adição de uma nova funcionalidade.

  • Responda ao feedback: Encare revisões como uma oportunidade de aprendizado, não como uma crítica pessoal.