# Guia de início rápido para pull requests

Proponha sua primeira alteração e leve-a desde sua primeira confirmação até uma solicitação de pull mesclada.

Uma solicitação de pull propõe alterações em um branch separado da base de código principal para que outras pessoas possam examinar as alterações antes de serem mescladas. Este guia de início rápido mostra a maneira mais simples de criar um pull request. Você criará uma ramificação, fará e confirmará alterações, abrirá uma solicitação de pull, responderá aos comentários e mesclará.

Você pode acompanhar pelo site GitHub ou com GitHub CLI, selecionando uma das abas acima.

## Ramificar ou bifurcar o repositório

Você começará criando um local isolado para trabalhar.

<div class="ghd-tool webui">

1. Em GitHub, navegue até a página principal do repositório no qual você deseja propor alterações.
2. Se você não tiver permissão de escrita, precisará de um fork. Clique em **Bifurcação** no canto superior direito e siga as etapas. Em seguida, continue na bifurcação do repositório.
3. Clique no menu seletor de ramificação na parte superior da lista de arquivos. Provavelmente diz **principal**. Digite um novo nome de ramificação e clique em **Criar ramificação *new-branch-name* a partir de main**.

</div>

<div class="ghd-tool cli"> 

1. Para usar GitHub CLI, você precisará instalá-lo primeiro. Consulte [Início rápido da CLI GitHub](/pt/enterprise-cloud@latest/github-cli/github-cli/quickstart).

2. Clone o repositório. Ou bifurque o repositório e clone-o localmente ao mesmo tempo.

* Se você tiver acesso de gravação ao repositório, clone o repositório:

  ```shell
  gh repo clone OWNER/REPO
  ```

* Se você não tiver acesso de gravação, você criará um **fork** primeiro e clonará tudo de uma vez.

  ```shell
  gh repo fork OWNER/REPO --clone
  ```

1. Mude para o diretório do repositório clonado.

   ```shell
   cd REPO
   ```

2. Crie e mude para uma nova ramificação.

   ```shell
   git checkout -b YOUR-BRANCH-NAME
   ```

</div>

## Criar ou editar seu código

Faça suas alterações no ramo. Para sua primeira solicitação de pull, mantenha a alteração focada e simples. Solicitações de pull menores são mais rápidas de examinar e mais fáceis de mesclar.

Experimente um dos seguintes procedimentos para fazer suas alterações:

* Edite arquivos localmente no IDE ou em um editor de texto.
* Edite um arquivo diretamente no GitHub navegando até ele e clicando <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="Edit this file" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>.

## Confirmar com frequência

Salve seu trabalho em commits pequenos e relevantes. Cada commit registra uma captura e uma mensagem descrevendo a alteração.

<div class="ghd-tool cli">

```shell
git add .
git commit -m "Describe your change"
git push --set-upstream origin YOUR-BRANCH-NAME
```

</div>

<div class="ghd-tool webui">

Ao editar um arquivo GitHub e estiver pronto para confirmar, você inserirá uma mensagem de confirmação e se comprometerá diretamente com seu branch.

1. Clique **em Confirmar alterações...**.
2. Na caixa **de mensagem Confirmar** , insira uma breve descrição das alterações feitas.
3. Selecione a ramificação na qual você está trabalhando.
4. Clique em **Propor alterações**.

Sua alteração será adicionada e registrada na ramificação.

</div>

## Abra sua solicitação de pull

Quando sua ramificação tiver as alterações que você deseja propor, abra um pull request tendo como destino a ramificação base.

<div class="ghd-tool webui">

1. Na página principal do repositório, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-pull-request" aria-label="The pull request icon" role="img"><path d="M1.5 3.25a2.25 2.25 0 1 1 3 2.122v5.256a2.251 2.251 0 1 1-1.5 0V5.372A2.25 2.25 0 0 1 1.5 3.25Zm5.677-.177L9.573.677A.25.25 0 0 1 10 .854V2.5h1A2.5 2.5 0 0 1 13.5 5v5.628a2.251 2.251 0 1 1-1.5 0V5a1 1 0 0 0-1-1h-1v1.646a.25.25 0 0 1-.427.177L7.177 3.427a.25.25 0 0 1 0-.354ZM3.75 2.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm0 9.5a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Zm8.25.75a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Z"></path></svg>Solicitações de pull** e, em seguida, clique em **Nova solicitação de pull**.
2. Para a ramificação **base**, main provavelmente já está selecionada e normalmente é a ramificação base na qual você vai integrar as alterações.
3. Para o branch de **comparação**, selecione o branch que contém suas alterações.
4. Clique em **Criar solicitação de pull**.
5. Insira um título e uma descrição que explica o que você mudou e por quê.
6. Você pode criar uma solicitação de pull pronta para revisão ou uma que esteja em um estado de rascunho.

* Se estiver pronto para revisão, clique em **Criar solicitação de pull**.
* Para compartilhar um trabalho em andamento, use a lista suspensa e selecione **Criar pull request em rascunho**.

</div>

<div class="ghd-tool cli">

Você pode criar uma solicitação de pull pronta para revisão ou uma que esteja em um estado de rascunho.

* Se estiver pronto para revisão:

  ```shell
  gh pr create
  ```

* Para compartilhar um trabalho em andamento

  ```shell
  gh pr create --draft
  ```

Em seguida, siga as instruções para definir a branch de base, o título e a descrição.

</div>

Se você fizer mais confirmações no mesmo branch, elas serão adicionadas automaticamente à sua solicitação de pull.

## Solicitar uma revisão

Para solicitar uma revisão por meio da caixa **Revisores**, você precisa ter acesso de gravação ao repositório e pode solicitar uma revisão a uma pessoa ou equipe com acesso de leitura ao repositório. Se você solicitar uma revisão, a pessoa ou a equipe receberá uma notificação. Em alguns casos, você verá revisores sugeridos que podem ser selecionados.

Se a caixa **Revisores** não estiver disponível para você, você poderá:

* Verifique o README do repositório para consultar as orientações sobre revisões de pull request e siga essas instruções.
* Se você conhece uma pessoa que pode fazer a revisão para você, entre em contato com ela e compartilhe o link para sua solicitação de pull.

## Tratar o feedback da revisão

Os revisores podem comentar, sugerir alterações ou solicitar alterações antes que uma solicitação de pull possa ser mesclada.

* Para aceitar a sugestão de um revisor, clique **em Sugestão de Confirmação** (ou lote vários e clique **em Sugestões de Confirmação**).
* Para fazer alterações mais amplas, edite seu código e envie novas confirmações por push para o mesmo branch. A solicitação de pull é atualizada automaticamente e executará novamente todas as verificações.
* Marque cada conversa como **Resolvida** depois de endereçá-la.

## Mesclar e implantar

Depois que as revisões necessárias e as verificações de status forem aprovadas, mescle a solicitação de pull para colocar suas alterações no branch base. Se você decidir não mesclar as alterações, poderá fechar a solicitação de pull.

> \[!TIP]
> Repositórios diferentes podem ter requisitos diferentes para mesclagem. Examine as diretrizes relevantes e siga suas instruções.

<div class="ghd-tool webui">

1. Na parte inferior da solicitação de pull, clique **em Mesclar solicitação de pull**.
2. Clique **em Confirmar** para concluir a mesclagem.
3. (Opcional) Exclua o branch principal para manter o repositório arrumado.

</div>

<div class="ghd-tool cli">

```shell
gh pr merge
```

Siga os prompts para escolher um método de mesclagem e, opcionalmente, excluir o branch.

</div>

## Próximas Etapas 

Após seu primeiro pull request, tente revisar o trabalho de outra pessoa. Consulte [Guia de início rápido para revisar pull requests](/pt/enterprise-cloud@latest/pull-requests/get-started/reviewing-pull-requests-quickstart).

## Leitura adicional

* [Writing code for a project](/pt/enterprise-cloud@latest/pull-requests/concepts/writing-code-for-a-project)
* [Solicitações de pull](/pt/enterprise-cloud@latest/pull-requests/reference/pull-requests)