{"meta":{"title":"Guia de início rápido para pull requests","intro":"Proponha sua primeira alteração e leve-a desde sua primeira confirmação até uma solicitação de pull mesclada.","product":"Solicitações de pull","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/pull-requests","title":"Solicitações de pull"},{"href":"/pt/enterprise-cloud@latest/pull-requests/get-started","title":"Introdução"},{"href":"/pt/enterprise-cloud@latest/pull-requests/get-started/pull-request-quickstart","title":"Início rápido da solicitação de pull"}],"documentType":"article"},"body":"# Guia de início rápido para pull requests\n\nProponha sua primeira alteração e leve-a desde sua primeira confirmação até uma solicitação de pull mesclada.\n\nUma solicitação de pull propõe alterações em um branch separado da base de código principal para que outras pessoas possam examinar as alterações antes de serem mescladas. Este guia de início rápido mostra a maneira mais simples de criar um pull request. Você criará uma ramificação, fará e confirmará alterações, abrirá uma solicitação de pull, responderá aos comentários e mesclará.\n\nVocê pode acompanhar pelo site GitHub ou com GitHub CLI, selecionando uma das abas acima.\n\n## Ramificar ou bifurcar o repositório\n\nVocê começará criando um local isolado para trabalhar.\n\n
\n\n1. Em GitHub, navegue até a página principal do repositório no qual você deseja propor alterações.\n2. Se você não tiver permissão de escrita, precisará de um fork. Clique em **Bifurcação** no canto superior direito e siga as etapas. Em seguida, continue na bifurcação do repositório.\n3. Clique no menu seletor de ramificação na parte superior da lista de arquivos. Provavelmente diz **principal**. Digite um novo nome de ramificação e clique em **Criar ramificação *new-branch-name* a partir de main**.\n\n
\n\n
\n\n1. Para usar GitHub CLI, você precisará instalá-lo primeiro. Consulte [Início rápido da CLI GitHub](/pt/enterprise-cloud@latest/github-cli/github-cli/quickstart).\n\n2. Clone o repositório. Ou bifurque o repositório e clone-o localmente ao mesmo tempo.\n\n* Se você tiver acesso de gravação ao repositório, clone o repositório:\n\n ```shell\n gh repo clone OWNER/REPO\n ```\n\n* Se você não tiver acesso de gravação, você criará um **fork** primeiro e clonará tudo de uma vez.\n\n ```shell\n gh repo fork OWNER/REPO --clone\n ```\n\n1. Mude para o diretório do repositório clonado.\n\n ```shell\n cd REPO\n ```\n\n2. Crie e mude para uma nova ramificação.\n\n ```shell\n git checkout -b YOUR-BRANCH-NAME\n ```\n\n
\n\n## Criar ou editar seu código\n\nFaça suas alterações no ramo. Para sua primeira solicitação de pull, mantenha a alteração focada e simples. Solicitações de pull menores são mais rápidas de examinar e mais fáceis de mesclar.\n\nExperimente um dos seguintes procedimentos para fazer suas alterações:\n\n* Edite arquivos localmente no IDE ou em um editor de texto.\n* Edite um arquivo diretamente no GitHub navegando até ele e clicando .\n\n## Confirmar com frequência\n\nSalve seu trabalho em commits pequenos e relevantes. Cada commit registra uma captura e uma mensagem descrevendo a alteração.\n\n
\n\nAo editar um arquivo GitHub e estiver pronto para confirmar, você inserirá uma mensagem de confirmação e se comprometerá diretamente com seu branch.\n\n1. Clique **em Confirmar alterações...**.\n2. Na caixa **de mensagem Confirmar** , insira uma breve descrição das alterações feitas.\n3. Selecione a ramificação na qual você está trabalhando.\n4. Clique em **Propor alterações**.\n\nSua alteração será adicionada e registrada na ramificação.\n\n
\n\n## Abra sua solicitação de pull\n\nQuando sua ramificação tiver as alterações que você deseja propor, abra um pull request tendo como destino a ramificação base.\n\n
\n\n1. Na página principal do repositório, clique em **Solicitações de pull** e, em seguida, clique em **Nova solicitação de pull**.\n2. Para a ramificação **base**, main provavelmente já está selecionada e normalmente é a ramificação base na qual você vai integrar as alterações.\n3. Para o branch de **comparação**, selecione o branch que contém suas alterações.\n4. Clique em **Criar solicitação de pull**.\n5. Insira um título e uma descrição que explica o que você mudou e por quê.\n6. Você pode criar uma solicitação de pull pronta para revisão ou uma que esteja em um estado de rascunho.\n\n* Se estiver pronto para revisão, clique em **Criar solicitação de pull**.\n* Para compartilhar um trabalho em andamento, use a lista suspensa e selecione **Criar pull request em rascunho**.\n\n
\n\n
\n\nVocê pode criar uma solicitação de pull pronta para revisão ou uma que esteja em um estado de rascunho.\n\n* Se estiver pronto para revisão:\n\n ```shell\n gh pr create\n ```\n\n* Para compartilhar um trabalho em andamento\n\n ```shell\n gh pr create --draft\n ```\n\nEm seguida, siga as instruções para definir a branch de base, o título e a descrição.\n\n
\n\nSe você fizer mais confirmações no mesmo branch, elas serão adicionadas automaticamente à sua solicitação de pull.\n\n## Solicitar uma revisão\n\nPara solicitar uma revisão por meio da caixa **Revisores**, você precisa ter acesso de gravação ao repositório e pode solicitar uma revisão a uma pessoa ou equipe com acesso de leitura ao repositório. Se você solicitar uma revisão, a pessoa ou a equipe receberá uma notificação. Em alguns casos, você verá revisores sugeridos que podem ser selecionados.\n\nSe a caixa **Revisores** não estiver disponível para você, você poderá:\n\n* Verifique o README do repositório para consultar as orientações sobre revisões de pull request e siga essas instruções.\n* Se você conhece uma pessoa que pode fazer a revisão para você, entre em contato com ela e compartilhe o link para sua solicitação de pull.\n\n## Tratar o feedback da revisão\n\nOs revisores podem comentar, sugerir alterações ou solicitar alterações antes que uma solicitação de pull possa ser mesclada.\n\n* Para aceitar a sugestão de um revisor, clique **em Sugestão de Confirmação** (ou lote vários e clique **em Sugestões de Confirmação**).\n* Para fazer alterações mais amplas, edite seu código e envie novas confirmações por push para o mesmo branch. A solicitação de pull é atualizada automaticamente e executará novamente todas as verificações.\n* Marque cada conversa como **Resolvida** depois de endereçá-la.\n\n## Mesclar e implantar\n\nDepois que as revisões necessárias e as verificações de status forem aprovadas, mescle a solicitação de pull para colocar suas alterações no branch base. Se você decidir não mesclar as alterações, poderá fechar a solicitação de pull.\n\n> \\[!TIP]\n> Repositórios diferentes podem ter requisitos diferentes para mesclagem. Examine as diretrizes relevantes e siga suas instruções.\n\n
\n\n1. Na parte inferior da solicitação de pull, clique **em Mesclar solicitação de pull**.\n2. Clique **em Confirmar** para concluir a mesclagem.\n3. (Opcional) Exclua o branch principal para manter o repositório arrumado.\n\n
\n\n
\n\n```shell\ngh pr merge\n```\n\nSiga os prompts para escolher um método de mesclagem e, opcionalmente, excluir o branch.\n\n
\n\n## Próximas Etapas \n\nApós seu primeiro pull request, tente revisar o trabalho de outra pessoa. Consulte [Guia de início rápido para revisar pull requests](/pt/enterprise-cloud@latest/pull-requests/get-started/reviewing-pull-requests-quickstart).\n\n## Leitura adicional\n\n* [Escrevendo código para um projeto](/pt/enterprise-cloud@latest/pull-requests/concepts/writing-code-for-a-project)\n* [Solicitações de pull](/pt/enterprise-cloud@latest/pull-requests/reference/pull-requests)"}