Visão geral
A Revisão de código reúne pull requests, alterações ao código, questões identificadas na revisão, comentários e verificações num só lugar. Pode rever as alterações de outra pessoa, acompanhar o feedback sobre as suas pull requests ou pedir ao Codex que explique uma alteração antes de responder.
O plugin Revisão de código permite fazer revisões na aplicação para computador e na Web. A revisão de pedidos de integração do GitLab está disponível em versão de pré-visualização. As revisões de código na nuvem para o GitLab não estão disponíveis.
Antes de começar
Use uma conta do repositório com acesso à pull request que pretende rever. As suas permissões no repositório determinam o que pode ler ou alterar.
Num espaço de trabalho gerido, tem de ter acesso ao plugin Revisão de código e a qualquer ligação necessária a uma aplicação. Instalar um plugin não concede acesso a um repositório.
Para saber mais sobre a configuração de plugins e os controlos do espaço de trabalho, consulte Plugins no ChatGPT e no Codex.
Encontrar uma pull request
Abra a Revisão de código para encontrar pull requests que criou ou que lhe pediram para rever. Use a pesquisa e os filtros para reduzir a lista e, em seguida, selecione uma pull request.
Verifique o repositório, o título, o autor e o ramo para confirmar que está a rever a alteração pretendida. A descrição explica o objetivo do autor; o diff mostra o código que foi alterado.
Rever as alterações
Leia a descrição e o resumo da pull request.
Analise os ficheiros alterados e as linhas relevantes no diff.
Reveja as questões identificadas e os comentários existentes.
Consulte os resultados dos testes, as verificações e os eventuais conflitos de integração por resolver.
Peça ao Codex que ajude a investigar qualquer questão que precise de uma análise mais aprofundada.
Confirme as questões identificadas automaticamente no código relevante antes de se basear nelas.
Fazer perguntas ao Codex sobre uma pull request
Use a conversa da pull request para fazer perguntas sobre as alterações ou investigar uma questão identificada. Indique o comportamento ou os critérios de revisão que considera importantes. Por exemplo:
«Explain how this change affects sign-in.»
«Check whether the new error path releases the database connection.»
«Show me the code that supports this finding.»
«Compare this revision with the review feedback and identify anything still unresolved.»
Também pode pedir ao Codex que prepare uma correção. Descreva a alteração pretendida e os eventuais limites do seu âmbito. Em seguida, analise o diff gerado e os resultados dos testes.
Por exemplo: «Address the error-handling finding. Keep the change limited to this function and add a test for the failing case.»
Reveja o resultado antes de enviar comentários, fazer commit das alterações ou integrá-las.
Rever pedidos de integração do GitLab
A versão de pré-visualização para o GitLab disponibiliza pedidos de integração na Revisão de código. Pode analisar alterações e usar o Codex para ajudar a compreender e resolver as questões levantadas na revisão.
Use a ligação ao GitLab correspondente à conta e aos projetos que pretende rever. Para saber mais sobre as opções de ligação e as permissões do repositório, consulte Ligar o GitLab ao ChatGPT e ao Codex.
A versão de pré-visualização na aplicação não inclui revisões de código na nuvem para o GitLab. Ligar o GitLab ou ver um pedido de integração na Revisão de código não ativa a revisão automática na nuvem para esse repositório.
Perguntas frequentes
Posso rever alterações locais antes de criar uma pull request?
Sim. Pode pedir ao Codex que reveja alterações locais. Consulte o Guia de revisão de código para conhecer as opções de revisão local.
Esta atualização transfere as minhas revisões na nuvem existentes para os novos ambientes na nuvem?
Não. Esta atualização não migra a revisão de código na nuvem existente para os novos ambientes na nuvem.