# Como criar uma solicitação de pull

Crie uma solicitação de pull para propor alterações ao código em um repositório.

Se você quiser criar uma nova ramificação para sua pull request, mas não tiver permissão de gravação no repositório, poderá fazer um fork do repositório primeiro. Confira [Creating a pull request from a fork](/pt/pull-requests/how-tos/create-pull-requests/creating-a-pull-request-from-a-fork) e [Garfos](/pt/pull-requests/reference/forks).

Ao criar sua solicitação de pull, você pode especificar em qual branch deseja mesclar suas alterações. As solicitações de pull só podem ser abertas entre duas ramificações diferentes.

> \[!NOTE]
> Para abrir uma pull request em um repositório público, você precisa ter acesso de gravação no branch principal ou de origem ou, para repositórios pertencentes à organização, você precisa ser membro da organização que é o proprietário do repositório para abrir uma pull request.

Você pode vincular uma solicitação de pull a um problema para mostrar que uma correção está em andamento e fechar automaticamente o problema quando a solicitação de pull é mesclada. Para saber mais, confira [Vinculando uma pull request a um problema](/pt/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue).

## Criando a solicitação de pull

<div class="ghd-tool webui">

1. Em GitHub, acesse a página principal do repositório.

2. No menu "Branch", escolha o branch que contém seus commits.

   ![Captura de tela do menu suspenso da lista de branches na página principal de um repositório.](/assets/images/help/pull_requests/branch-dropdown.png)

3. Acima da lista de arquivos, na faixa amarela, clique em **Comparação e solicitação de pull** para criar uma solicitação de pull para o branch associado.

   ![Captura de tela da faixa acima da lista de arquivos.](/assets/images/help/pull_requests/pull-request-compare-pull-request.png)

4. Use o menu suspenso da ramificação *base* para selecionar a ramificação na qual você deseja mesclar suas alterações. Em seguida, use o menu suspenso da ramificação *compare* para escolher a ramificação de tópico na qual você fez suas alterações.

5. Digite um título e uma descrição para a pull request.

6. Para criar uma solicitação de pull pronta para revisão, clique em **Criar Solicitação de Pull**.
   Para criar uma solicitação de pull de rascunho, use o manu suspenso, selecione **Criar Solicitação de Pull de Rascunho** e clique em **Solicitação de Pull de Rascunho**. Se você for membro de uma organização, talvez seja necessário solicitar acesso a pull requests de rascunho a um proprietário da organização. Confira [Solicitações de pull](/pt/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests).

> \[!TIP]
> Depois de criar uma pull request, solicite a uma pessoa específica que [revise suas alterações propostas](/pt/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request). Para saber mais, confira [Solicitando revisão de pull request](/pt/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/requesting-a-pull-request-review).

Após a revisão do seu pull request, ele poderá ser incorporado ao repositório. Consulte [Merging a pull request](/pt/pull-requests/how-tos/merge-and-close-pull-requests/merging-a-pull-request).

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-github-cli).

Para criar uma solicitação de pull, use o subcomando `gh pr create`.

```shell
gh pr create
```

Para atribuir uma solicitação de pull a uma pessoa, use o sinalizador `--assignee` ou `-a`. Você pode usar `@me` para atribuir a solicitação de pull automaticamente.

```shell
gh pr create --assignee "@octocat"
```

Para especificar o branch no qual deseja mesclar a solicitação de pull, use o sinalizador `--base` ou `-B`. Para especificar o branch que contém os commits da sua solicitação de pull, use o sinalizador `--head` ou `-H`.

```shell
gh pr create --base my-base-branch --head my-changed-branch
```

Para incluir um título e um corpo na nova solicitação de pull, use os sinalizadores `--title` e `--body`.

```shell
gh pr create --title "The bug is fixed" --body "Everything works again"
```

Para marcar um pull request como rascunho, use o sinalizador `--draft`.

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

Para adicionar rótulos ou marcos ao novo pull request, use as opções `--label` e `--milestone`.

```shell
gh pr create --label "bug,help wanted" --milestone octocat-milestone
```

Para adicionar a nova solicitação de pull a um projeto específico, use o sinalizador `--project`.

```shell
gh pr create --project octocat-project
```

Para atribuir uma pessoa ou uma equipe como revisor, use o sinalizador `--reviewer`.

```shell
gh pr create --reviewer monalisa,hubot --reviewer myorg/team-name
```

Para criar a solicitação de pull no navegador da Web padrão, use o sinalizador `--web`.

```shell
gh pr create --web
```

</div>

<div class="ghd-tool desktop">

1. Clique em **Visualizar Pull Request**.
   GitHub Desktop abre uma caixa de diálogo de visualização que mostra a diferença das alterações entre o branch atual e o branch base.

   Como alternativa, para ir direto para GitHub e criar seu pull request, selecione o ícone de menu suspenso e clique em **Criar Pull Request**.

2. Confirme se a ramificação no menu suspenso **base:** é a ramificação em que deseja mesclar suas alterações.

   ![Captura de tela da janela de diálogo "Abrir uma Solicitação de Pull". Um botão com um ícone de menu suspenso, rotulado "base: desenvolvimento", está destacado em laranja.](/assets/images/help/desktop/base-branch-selection.png)

GitHub Desktop indica se a ramificação atual pode ser mesclada automaticamente à ramificação base.

![Captura de tela da janela de diálogo "Abrir uma Solicitação de Pull". Um rótulo de status informando "Não é possível fazer a mesclagem automaticamente" está realçado com um contorno em laranja.](/assets/images/help/desktop/preview-dialog-merge-status.png)

1. Clique em **Criar Solicitação de Pull**.
   GitHub Desktop abre seu navegador padrão e leva você para GitHub.
2. Digite um título e uma descrição para a pull request.
3. Para criar uma solicitação de pull pronta para revisão, clique em **Criar Solicitação de Pull**.
   Para criar uma solicitação de pull de rascunho, use o manu suspenso, selecione **Criar Solicitação de Pull de Rascunho** e clique em **Solicitação de Pull de Rascunho**. Se você for membro de uma organização, talvez seja necessário solicitar acesso a pull requests de rascunho a um proprietário da organização. Confira [Solicitações de pull](/pt/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests).

</div>

<div class="ghd-tool codespaces">

1. Depois de confirmar alterações na cópia local do repositório, clique no ícone **Criar Solicitação de Pull** .

![Captura de tela da parte superior da barra lateral "Controle do código-fonte". O ícone de solicitação de pull é realçado com um contorno laranja escuro.](/assets/images/help/codespaces/codespaces-commit-pr-button.png)

1. Verifique se o branch local e o repositório de onde você está mesclando, e o branch remoto e o repositório para onde você está mesclando, estão corretos. Em seguida, dê à pull request um título e uma descrição.

![Captura de tela da barra lateral "GitHub Solicitação de Pull" com um formulário para criar uma solicitação de pull, incluindo os campos "Título" e "Descrição".](/assets/images/help/codespaces/codespaces-commit-pr.png)

1. Clique em **Criar**.

Para obter mais informações sobre como criar pull requests em GitHub Codespaces, consulte [Usando GitHub codespaces para solicitações de pull](/pt/codespaces/developing-in-a-codespace/using-github-codespaces-for-pull-requests).

</div>

## Como fazer alterações em arquivos na pull request

Depois de abrir seu pull request, você pode continuar a alterar os arquivos adicionando novos commits ao branch de origem.

<div class="ghd-tool webui">

Você também pode fazer alterações nos arquivos no GitHub site.

1. No GitHub, navegue até um pull request em um repositório.
2. Na pull request, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-file-diff" aria-label="file-diff" role="img"><path d="M1 1.75C1 .784 1.784 0 2.75 0h7.586c.464 0 .909.184 1.237.513l2.914 2.914c.329.328.513.773.513 1.237v9.586A1.75 1.75 0 0 1 13.25 16H2.75A1.75 1.75 0 0 1 1 14.25Zm1.75-.25a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25h10.5a.25.25 0 0 0 .25-.25V4.664a.25.25 0 0 0-.073-.177l-2.914-2.914a.25.25 0 0 0-.177-.073ZM8 3.25a.75.75 0 0 1 .75.75v1.5h1.5a.75.75 0 0 1 0 1.5h-1.5v1.5a.75.75 0 0 1-1.5 0V7h-1.5a.75.75 0 0 1 0-1.5h1.5V4A.75.75 0 0 1 8 3.25Zm-3 8a.75.75 0 0 1 .75-.75h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1-.75-.75Z"></path></svg> Files changed**.

   ![Captura de tela das guias de uma solicitação de pull. A guia "Arquivos alterados" está contornada em laranja escuro.](/assets/images/help/pull_requests/pull-request-tabs-changed-files.png)
3. Role a página para baixo até o arquivo no qual deseja fazer alterações.
   * Se a pull request tiver muitos arquivos, você poderá usar o filtro para localizar o arquivo.
4. Acima do arquivo que você deseja alterar, clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Show options" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>.

![Captura de tela das opções acima de um arquivo na guia “Arquivo alterado”. O botão “Mostrar opções” está realçado com um retângulo laranja.](/assets/images/help/pull_requests/menu-on-pull-request-file.png)

1. No menu, selecione **Editar arquivo**.
2. Faça suas alterações no editor. Ao confirmar sua alteração, escolha fazer commit diretamente de volta ao branch principal.

</div>

## Leitura adicional

* [Creating a pull request from a fork](/pt/pull-requests/how-tos/create-pull-requests/creating-a-pull-request-from-a-fork)
* [Mantendo o seu pull request em sincronia com o branch de base](/pt/pull-requests/how-tos/create-pull-requests/keeping-your-pull-request-in-sync-with-the-base-branch)
* [Changing the base branch of a pull request](/pt/pull-requests/how-tos/create-pull-requests/changing-the-base-branch-of-a-pull-request)
* [Criar um problema](/pt/issues/tracking-your-work-with-issues/using-issues/creating-an-issue)
* [Atribuindo problemas e solicitações de pull a outros usuários GitHub](/pt/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users)
* [Como escrever no GitHub](/pt/get-started/writing-on-github)