> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-2-da-solicitacao-de-pull-revisao.md).

# Etapa 2 da solicitação de pull: revisão

{% hint style="warning" %}

#### Escrito para a interface antiga

Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o [Para onde foi](/devops/devops-pt-br/transicao-para-a-nova-ui-ux/para-onde-foi.md) artigo.
{% endhint %}

## ![](https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Visão geral

Este artigo explica como concluir o processo de revisão de um Pull Request, que envolve tanto o criador quanto os revisores atribuídos. Realizar revisões completas é essencial para manter a qualidade do código.

{% hint style="info" %}

#### Boas práticas

* Sempre adicione pelo menos um revisor para garantir a responsabilidade.
* Use o campo de descrição para resumir as principais alterações para os revisores.
* Faça o merge somente quando todos os conflitos forem resolvidos e os testes tiverem passado.
* Use **Solicitar alterações** em vez de simplesmente não aprovar, pois isso mantém um fluxo de trabalho claro.
* Evite a autoavaliação e o merge sem um revisor, a menos que seja uma correção crítica de tempo.
  {% endhint %}

### Etapas do Pull Request

Explore nossa série de artigos que orientam você em cada etapa do processo de Pull Request. Você pode lê-los em ordem ou selecionar um artigo específico para obter orientação detalhada sobre uma fase em particular.

* [Etapa 1 da solicitação de pull: criação](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-1-da-solicitacao-de-pull-criacao.md)
* [Etapa 2 da solicitação de pull: revisão](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-2-da-solicitacao-de-pull-revisao.md)
* [Etapa 3 da solicitação de pull: mesclagem](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-3-da-solicitacao-de-pull-mesclagem.md)

## Aba Visão geral do Pull Request

Os detalhes de um Pull Request ajudam revisores e colaboradores a obter contexto sobre a solicitação. A **Visão geral** aba tem duas seções para revisão: **Detalhes do Pull Request** e **Revisores do Pull Request**.

<div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FBRYwguQOGMaWimAFbN7K%2FPullRequestReviewing-Overview-01.png?alt=media&amp;token=59696f06-e359-4855-abb0-007c998e0e52" alt="" width="563"><figcaption></figcaption></figure></div>

### Detalhes do Pull Request

<table><thead><tr><th width="160">Campo</th><th>Descrição</th></tr></thead><tbody><tr><td><strong>Status</strong></td><td>Estado atual do Pull Request (<strong>Criado</strong>, <strong>Revisão solicitada</strong>, <strong>Alterações solicitadas</strong>, e <strong>Aprovado</strong>).</td></tr><tr><td><strong>Branch de destino</strong></td><td>A branch onde as alterações serão mescladas.</td></tr><tr><td><strong>Branch de origem</strong></td><td>A branch de onde as alterações se originam.</td></tr><tr><td><strong>Criado por</strong></td><td>Usuário que criou o Pull Request.</td></tr><tr><td><strong>Data de criação</strong></td><td>Quando o Pull Request foi criado pela primeira vez.</td></tr><tr><td><strong>Data de atualização</strong></td><td>Quando ocorreu a última atividade ou alteração no Pull Request.</td></tr><tr><td><strong>Descrição</strong></td><td>Resumo das alterações deste Pull Request. Escrito pelo criador do Pull Request.</td></tr></tbody></table>

### Revisores do Pull Request

A **Revisores** seção mostra os usuários atribuídos para revisar este Pull Request. O status de cada revisor é indicado por um ícone que ilustra o estado da revisão (revisão pendente, alterações solicitadas ou aprovado). Veja as instruções abaixo para mais detalhes sobre o processo de revisão.

## Revisar Pull Request

{% stepper %}
{% step %}

### Aguarde a verificação de conflitos de merge

1. Quando um Pull Request é criado, ele verifica inicialmente se há conflitos de merge, indicados por uma faixa cinza.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FNszuvoCa9QQTAF4RFsx3%2FPullRequestReviewing-S01-01.png?alt=media&amp;token=1461350d-8dd5-4059-ac0f-2ec196f4f02d" alt="" width="563"><figcaption></figcaption></figure></div>
2. Aguarde a faixa mudar para uma das seguintes opções:
   1. **Verde**: Este branch pode ser mesclado
   2. **Laranja**: Este branch tem conflitos que devem ser resolvidos
3. Se o branch puder ser mesclado, você pode continuar revisando o Pull Request seguindo as instruções deste artigo.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FvxrujNjV46kt1A1BMwAo%2FPullRequestReviewing-S01-02.png?alt=media&amp;token=9e1ad90a-51dc-43bb-954e-f82b3f5bf622" alt="" width="375"><figcaption></figcaption></figure></div>
4. Se o branch tiver conflitos, você deve resolvê-los antes de continuar a revisão deste Pull Request. Veja o artigo a seguir para aprender como resolver conflitos.
   1. [Resolvendo conflitos da solicitação de pull](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/resolvendo-conflitos-da-solicitacao-de-pull.md)
      {% endstep %}

{% step %}

### (Opcional) Adicionar revisores

Adicionar revisores garante a qualidade do código, ajuda a identificar conflitos cedo e reforça os processos de aprovação da equipe. Todos os revisores devem clicar **Aprovar** antes que o Pull Request possa ser mesclado.

{% hint style="success" %}

#### Autoavaliação

Se nenhum revisor for adicionado, você pode revisar as alterações do seu próprio Pull Request. Nenhuma revisão formal ou aprovação é necessária. Após revisar, você pode fazer o merge sem aprovação adicional.
{% endhint %}

1. Na **Revisores** seção, clique no **lápis** ícone.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F28Zho7daWf4WY8z0uhjV%2FPullRequestReviewing-S02-01.png?alt=media&amp;token=7c43829b-5f00-4d56-ae81-f4f406347529" alt="" width="563"><figcaption></figcaption></figure></div>
2. Clique em **Adicionar** para cada usuário que você deseja que revise este Pull Request.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F51xaVcK8V3PW05ZBYbM4%2FPullRequestReviewing-S02-02.png?alt=media&amp;token=019baa20-fcdd-4dba-b9ce-274313a65575" alt="" width="375"><figcaption></figcaption></figure></div>
3. Clique em **Salvar**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F1jEfZrBTs2qkOQuqQNtV%2FPullRequestReviewing-S02-03.png?alt=media&amp;token=a3226472-5ea1-479b-a0e5-6f7adfb3f400" alt="" width="375"><figcaption></figcaption></figure></div>
4. Os revisores adicionados serão listados na **Revisores** seção, e o status do Pull Request mudará para **Revisão solicitada**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F9y22mlFuqUNLxood84er%2FPullRequestReviewing-S02-04.png?alt=media&amp;token=d43f786f-671b-486e-922b-acee09960900" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Revisar alterações

Para revisar o Pull Request, cada revisor deve entrar no Cloud DevOps e seguir estas etapas:

{% hint style="info" %}
Pull requests aguardando revisão são marcados com o status **Revisão solicitada**, e os **Revisores**ícones ' são exibidos.
{% endhint %}

{% hint style="success" %}

#### Autoavaliação

Se você estiver fazendo a autoavaliação, ainda assim deve revisar cada componente antes de fazer o merge.
{% endhint %}

1. Clique em **Pull requests** no menu lateral esquerdo.
2. Clique no Pull Request para revisar.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FAqKE9j73OKUHh5CoAD8y%2FPullRequestReviewing-S03-01.png?alt=media&amp;token=4663cae1-4c59-4a2b-9e9c-1c18b52f40bc" alt="" width="563"><figcaption></figcaption></figure></div>
3. Clique na **Componentes alterados** guia.
4. Clique em um componente para revisar.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FDpVD3gOYXoVoCSJTDrRP%2FPullRequestReviewing-S03-02.png?alt=media&amp;token=fcb6ef95-6da5-4919-98a8-b146fcce4d2c" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Todos os componentes devem ser revisados.
{% endhint %}

5. Ao visualizar um componente, o código-fonte de **Destino** e **Origem** é exibido lado a lado com as diferenças destacadas.

   1. **Vermelho**: Linhas a serem removidas.
   2. **Verde**: Linhas a serem adicionadas.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FoPOvjdDju542rvYZmtky%2FPullRequestReviewing-S03-03.png?alt=media&amp;token=9393dac8-de18-47f7-bb63-6a3a884896eb" alt="" width="563"><figcaption></figcaption></figure></div>
6. Repita o processo de revisão para cada componente.
   {% endstep %}

{% step %}

### (Opcional) Solicitar alterações

Ao revisar, use **Solicitar alterações** para indicar que são necessárias correções antes da aprovação. Esse status solicita ao criador do Pull Request que atualize o branch de origem com as alterações necessárias. Como a solicitação não especifica o que precisa ser alterado, comunique diretamente à sua equipe as alterações específicas necessárias.

{% hint style="success" %}

#### Autoavaliação

Se você estiver fazendo a autoavaliação, você não pode **Solicitar alterações**.
{% endhint %}

1. Clique em **Solicitar alterações**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FmtUEh3cAxhX6qDQ2Ysqw%2FPullRequestReviewing-S04-01.png?alt=media&amp;token=5c2674af-b702-46b9-8db6-70062b4e5e92" alt="" width="563"><figcaption></figcaption></figure></div>
2. Depois de solicitar alterações, o status do Pull Request mudará para **Alterações solicitadas**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Fh3WNpmtsxw7JosB8f1Ie%2FPullRequestReviewing-S04-02.png?alt=media&amp;token=9477d9c8-cd12-4471-a5cd-2d64361e6f29" alt="" width="563"><figcaption></figcaption></figure></div>

#### Reenviar para revisão

Depois de fazer as alterações solicitadas, reenviar o Pull Request para revisão pelo revisor que as solicitou.

1. Clique no Pull Request.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FQ0Fd4L7MCILU6c4gukdY%2FPullRequestReviewing-S04-03.png?alt=media&amp;token=71acd999-72d9-447a-a378-2d4ef73b380e" alt="" width="563"><figcaption></figcaption></figure></div>
2. Clique na **Atualizar** ícone ao lado do revisor que solicitou a revisão.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FIGx3xI7UlUb33mHTobYV%2FPullRequestReviewing-S04-04.png?alt=media&amp;token=3312a2d2-a65d-4662-b5f8-de766e7eb862" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Aprovar

Depois que um revisor concluir a revisão de todos os componentes e de todas as solicitações de alteração atendidas, ele deve aprovar o Pull Request antes que ele possa ser mesclado.

{% hint style="warning" %}
O Pull Request não será aprovado até que todos os revisores cliquem em **Aprovar**.
{% endhint %}

{% hint style="success" %}

#### Autoavaliação

Ao fazer a autoavaliação, você não pode **Aprovar** o Pull Request. Mas, como não há revisores, a aprovação não é necessária antes do merge.
{% endhint %}

1. Clique em **Aprovar**.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F0iNVhb6mdclluMAmW1Aw%2FPullRequestReviewing-S05-01.png?alt=media&amp;token=9f2b7510-c159-4cb7-a4e1-1b4d7766517e" alt="" width="563"><figcaption></figcaption></figure></div>
2. Depois que todos os revisores aprovarem, o status do Pull Request mudará para **Aprovado**, e ele poderá ser mesclado.

   <div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F4F8u8tx6fNcpLXXthvja%2FPullRequestReviewing-S05-02.png?alt=media&amp;token=458e0f62-a12f-4777-ba07-1ffcd1d2e135" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Próxima etapa: merge

Depois que o Pull Request for aprovado, as alterações do branch de origem estarão prontas para serem mescladas no branch de destino. Prossiga para o artigo a seguir para obter instruções sobre o processo de merge.

* [Etapa 3 da solicitação de pull: mesclagem](/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-3-da-solicitacao-de-pull-mesclagem.md)

<div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG9DKua3MnrgmW0zZinu4%2FPullRequestReviewing-S06-01.png?alt=media&amp;token=132d0dc1-87b8-438e-a64e-96e0055e7f5b" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/devops/devops-pt-br/solicitacoes-de-pull/processo-de-solicitacao-de-pull/etapa-2-da-solicitacao-de-pull-revisao.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.