{"meta":{"title":"Ajudando outras pessoas a revisar suas alterações","intro":"Crie solicitações de pull claras e focadas que melhorem a colaboração, simplifiquem as revisões e mantenham sua equipe informada sobre suas alterações.","product":"Solicitações de pull","breadcrumbs":[{"href":"/pt/pull-requests","title":"Solicitações de pull"},{"href":"/pt/pull-requests/concepts","title":"Concepts"},{"href":"/pt/pull-requests/concepts/helping-others-review-your-changes","title":"Ajudar outras pessoas a revisar suas alterações"}],"documentType":"article"},"body":"# Ajudando outras pessoas a revisar suas alterações\n\nCrie solicitações de pull claras e focadas que melhorem a colaboração, simplifiquem as revisões e mantenham sua equipe informada sobre suas alterações.\n\nAo criar uma solicitação de pull, você está solicitando que outras pessoas examinem suas alterações e forneçam comentários. Pull requests focados, claros e fáceis de seguir ajudam os revisores a fornecer feedback melhor e a fazer sugestões mais assertivas.\n\n## Facilitando a revisão de suas alterações\n\nO contexto claro ajuda os revisores a entender rapidamente o que mudou e por que isso importa. Ele reduz o vai-e-vem, torna a revisão mais rápida e ajuda sua equipe a se concentrar nas partes mais importantes da mudança.\n\n### Escrever pull requests pequenas\n\nPull requests pequenos e focados são mais fáceis de revisar e mais seguros para mesclar. Eles ajudam os revisores a entender a finalidade da alteração, detectar problemas mais rapidamente e seguir o histórico do projeto mais tarde.\n\nQuando uma alteração se torna grande, considere dividi-la em pull requests menores, cada um com uma finalidade específica.\n\n### Forneça contexto e orientação\n\nUm título claro e uma descrição ajudam os revisores a entender o problema, a abordagem e o resultado. Um bom contexto geralmente explica por que a mudança é necessária, o que mudou e onde os revisores devem prestar atenção especial.\n\nAs orientações são especialmente úteis quando um pull request envolve muitos arquivos ou exige uma ordem de revisão específica. Por exemplo, você pode apontar os revisores para os arquivos mais importantes primeiro ou explicar qual tipo de comentário seria mais útil. Você também pode usar GitHub Copilot para gerar um resumo da solicitação de pull.\n\n### Revise sua própria pull request primeiro\n\nRevisar sua própria solicitação de pull antes de pedir a outras pessoas para revisá-la ajuda você a detectar erros mais cedo. Isso também mostra aos revisores que o pull request está pronto para receber a atenção deles.\n\nUma autorevisão pode incluir revisar o diff, verificar se houve alterações acidentais e garantir que as compilações ou os testes relevantes tenham sido executados.\n\n### Revisão de segurança\n\nAs revisões de segurança ajudam a capturar o risco antes que uma solicitação de pull seja mesclada. Isso é especialmente importante quando uma solicitação de pull altera dependências, autenticação, permissões, fluxos de trabalho ou código que manipula dados confidenciais.\n\nGitHub pode revelar informações de segurança em pull requests, como alterações de dependências, resultados de revisões de dependências e verificações code scanning. Use esses sinais para resolver problemas mais cedo ou para realçar riscos que precisam de atenção do revisor.\n\nSe code scanning estiver configurado como uma verificação no seu repositório, GitHub Copilot Autofix pode sugerir correções para vulnerabilidades de segurança.\n\n## Mantendo a equipe informada\n\nAs solicitações de pull podem fazer mais do que as alterações de código do documento. Elas também são uma maneira de manter sua equipe informada sobre o status do seu trabalho. O progresso visível ajuda a reduzir atualizações de status separadas e mantém todos alinhados.\n\n### Usar GitHub Copilot para gerar resumos de solicitação de pull\n\n> \\[!NOTE]\n> Recursos Copilot exigem um plano Copilot. Consulte [Planos para GitHub Copilot](/pt/copilot/get-started/plans).\n\nCopilot pode gerar um resumo da solicitação de pull em GitHub. Um resumo gerado pode ajudar os revisores a entender as principais alterações, mas você deve revisá-la com cuidado e adicionar contexto que só você conhece.\n\nOs resumos são mais úteis quando explicam o objetivo da alteração, destacam os arquivos importantes e ressaltam qualquer ponto que os revisores devam examinar com atenção.\n\n### Link para problemas ou projetos relacionados\n\nConectar um pull request a issues ou projetos mostra como o trabalho se encaixa no projeto maior. Os links ajudam os revisores a entender a prioridade, acompanhar o progresso e encontrar discussões relacionadas.\n\nUse palavras-chave de fechamento de issue quando um pull request precisar fechar uma issue após a mesclagem. Você também pode adicionar um link para Projects para que as pessoas possam acompanhar o trabalho em um único lugar.\n\n### Destacar o status com rótulos\n\nOs rótulos de status ajudam os revisores a entender se uma solicitação de pull está pronta para revisão, bloqueada ou ainda em andamento. Os rótulos claros facilitam que as pessoas priorizem as revisões e evitem revisar o trabalho antes que ele esteja pronto.\n\n## Leitura adicional\n\n* [Resolvendo revisões](/pt/pull-requests/concepts/resolving-reviews)\n* [Vinculando uma pull request a um problema](/pt/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue)\n* [Gerenciar etiquetas](/pt/issues/using-labels-and-milestones-to-track-work/managing-labels)"}