Visão Geral dos Pull Requests

Visão geral

Pull Requests são uma parte fundamental do fluxo de trabalho Cloud DevOps, permitindo atualizações de um branch de origem para um branch de destino. Eles foram projetados para apoiar a colaboração por meio de revisões de código que devem ser aprovadas antes da mesclagem.

Benefícios dos Pull Requests:

• Revisão de Código: Permite exame minucioso das alterações antes da mesclagem.

• Detecção de Conflitos: Identifica e resolve conflitos cedo no processo.

• Histórico de Release Limpo: Mantém um histórico do projeto organizado e claro.

Página de Visão Geral do Pull Request

A página de visão geral do Pull Request fornece um instantâneo abrangente de todas as solicitações ativas. Servindo como o hub central, ela facilita o acompanhamento do progresso e a prontidão para mesclagem. Cada Pull Request exibe estes detalhes.

Pull Requests Ativos

A página de Visão Geral de Pull Requests lista apenas Pull Requests ativos. Uma vez que um Pull Request é Mesclado ou Fechado, ele é removido da lista de Pull Requests ativos.

Título e ID	O título do Pull Request e o número de ID. Cada Pull Request recebe um número de ID sequencial exclusivo.
Status	O status do Pull Request pode ser um dos seguintes: Criado, Revisão Solicitada, Alterações Solicitadas e Aprovado.
Autor	O usuário do Flosum que criou o Pull Request.
Última Atividade	O tempo decorrido desde a última atividade do Pull Request.
Destino e Origem	Os branches de destino e origem são listados com uma seta apontando da origem para o destino. Clicar em um branch leva você à página principal de branches.
Revisores	Os usuários do Flosum que são designados como revisores do Pull Request.

Clicar em um Pull Request leva você à página de visão geral da solicitação, onde pode executar ações sobre ele.

Os Três Pontos Verticais menu no final de um Pull Request oferece as seguintes opções:

• Editar: Leva você à página de edição do Pull Request para alterar: Branch de destino, Branch de origem, Nome, e Descrição.

• Fechar: Encerra o Pull Request sem mesclar. Uma vez fechado, o Pull Request não é mais exibido na lista de Pull Requests e nenhuma ação adicional pode ser realizada.

Pesquisa, Ordenação e Filtragem

A página de Pull Requests pode ser pesquisada, filtrada e ordenada usando as seguintes ferramentas.

• Pesquisar – pesquisar por nome ou ID do Pull Request.

• Autores – filtrar pelo criador do PR.

• Status – filtrar pelo estado (Criado, Revisão Solicitada, Alterações Solicitadas, Aprovado).

• Revisores – filtrar por revisores designados.

• Última Atividade – ordenar os pull requests por:

  • Ordenar por nome A–Z – ordem alfabética.

  • Ordenar por nome Z–A – ordem alfabética inversa.

  • Última atividade – atualizações mais recentes primeiro.

  • Atividade mais antiga – atualizações mais antigas primeiro.

• Intervalo de Datas – filtrar por período de criação ou atualização. Use o widget de datas para inserir um intervalo.

Status dos Pull Requests

Status	Descrição
Criado	Pull Request aberto mas não revisado.
Revisão Solicitada	Revisores designados, mas aguardando o feedback deles.
Alterações Solicitadas	Revisores solicitaram revisões antes da aprovação.
Aprovado	Pull Request aprovado pelos revisores e pronto para mesclar.

Processo de Pull Request

Pull Requests envolvem três etapas principais: criação, revisão e mesclagem. Se surgirem conflitos durante a criação, eles devem ser resolvidos antes da mesclagem. Orientações detalhadas para cada etapa são fornecidas nos artigos a seguir.

• Pull Request Etapa 1: Criação

• Pull Request Etapa 2: Revisão

• Pull Request Etapa 3: Mesclagem

• Resolvendo Conflitos de Pull Request

Melhores Práticas

• Sempre revise um Pull Request antes de mesclar branches de funcionalidade ou correção de bugs.

• Escreva títulos e descrições claras para os revisores.

• Atribua pelo menos um revisor para responsabilidade.

• Resolva conflitos do Pull Request antes de mesclar.

• Feche Pull Requests obsoletos para manter a lista limpa.