Creating a pull request

Create a pull request to propose changes to the code in a repository.

¿Quién puede utilizar esta característica?

Anyone with read access to a repository can create a pull request.

Tool navigation

En este artículo

If you want to create a new branch for your pull request but don't have write permissions to the repository, you can fork the repository first. See Creating a pull request from a fork and Forks.

When you create your pull request, you can specify which branch you want to merge your changes into. Pull requests can only be opened between two different branches.

Nota:

Para abrir una solicitud de cambios en un repositorio público, debes tener acceso de escritura a la rama principal activa o a la rama de origen, o en caso de los repositorios propiedad de una organización, debes ser miembro de la organización propietaria del repositorio para hacerlo.

Puede vincular una solicitud de incorporación de cambios a un problema para mostrar que una corrección está en curso y cerrar automáticamente el problema cuando se combina la solicitud de incorporación de cambios. Para más información, consulta Vincular una solicitud de cambios a una propuesta.

Creating the pull request

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. In the "Branch" menu, choose the branch that contains your commits.

    Screenshot of the branch dropdown menu on the main page of a repository.

  3. Encima de la lista de archivos, en el banner amarillo, haz clic en Comparar y solicitud de incorporación de cambios para crear una solicitud de incorporación de cambios para la rama asociada.

    Captura de pantalla del banner de encima de la lista de archivos.

  4. Use the base branch dropdown menu to select the branch where you want to merge your changes. Then, use the compare branch dropdown menu to choose the topic branch where you made your changes.

  5. Escribe un título y una descripción para tu solicitud de extracción.

  6. Para crear una solicitud de incorporación de cambios que esté lista para revisión, haga clic en Crear solicitud de incorporación de cambios. Para crear un borrador de una solicitud de incorporación de cambios, use el menú desplegable y seleccione Crear solicitud de incorporación de cambios de borrador, y después haga clic en Solicitud de incorporación de cambios de borrador. Si eres miembro de una organización, es posible que tengas que solicitar acceso a borradores de solicitudes de incorporación de cambios de un propietario de la organización. Consulta Pull requests.

Sugerencia

Después de crear una solicitud de cambios, puedes pedir a una persona concreta que revise los cambios propuestos. Para más información, consulta Requesting a pull request review.

After your pull request has been reviewed, it can be merged into the repository. See Merging a pull request.

Nota:

Para más información sobre GitHub CLI, consulta Acerca de GitHub CLI.

To create a pull request, use the gh pr create subcommand.

gh pr create

To assign a pull request to an individual, use the --assignee or -a flags. You can use @me to self-assign the pull request.

gh pr create --assignee "@octocat"

To specify the branch into which you want the pull request merged, use the --base or -B flags. To specify the branch that contains commits for your pull request, use the --head or -H flags.

gh pr create --base my-base-branch --head my-changed-branch

To include a title and body for the new pull request, use the --title and --body flags.

gh pr create --title "The bug is fixed" --body "Everything works again"

To mark a pull request as a draft, use the --draft flag.

gh pr create --draft

To add labels or milestones to the new pull request, use the --label and --milestone flags.

gh pr create --label "bug,help wanted" --milestone octocat-milestone

To add the new pull request to a specific project, use the --project flag.

gh pr create --project octocat-project

To assign an individual or team as reviewers, use the --reviewer flag.

gh pr create --reviewer monalisa,hubot --reviewer myorg/team-name

To create the pull request in your default web browser, use the --web flag.

gh pr create --web

  1. Click Preview Pull Request. GitHub Desktop opens a preview dialog that shows the diff of the changes between your current branch and the base branch.

    Alternatively, to go straight to GitHub to create your pull request, select the dropdown icon and click Create Pull Request.

  2. Confirm that the branch in the base: dropdown menu is the branch where you want to merge your changes.

    Screenshot of the "Open a Pull Request" dialog window. A button with a dropdown icon, labeled "base: development", is outlined in orange.

    GitHub Desktop tells you whether the current branch can be automatically merged into the base branch.

    Screenshot of the "Open a Pull Request" dialog window. A status label stating "Can't automatically merge" is highlighted with an orange outline.

  3. Click Create Pull Request. GitHub Desktop opens your default browser and takes you to GitHub.

  4. Escribe un título y una descripción para tu solicitud de extracción.

  5. Para crear una solicitud de incorporación de cambios que esté lista para revisión, haga clic en Crear solicitud de incorporación de cambios. Para crear un borrador de una solicitud de incorporación de cambios, use el menú desplegable y seleccione Crear solicitud de incorporación de cambios de borrador, y después haga clic en Solicitud de incorporación de cambios de borrador. Si eres miembro de una organización, es posible que tengas que solicitar acceso a borradores de solicitudes de incorporación de cambios de un propietario de la organización. Consulta Pull requests.

  1. After you commit changes to your local copy of the repository, click the Create Pull Request icon.
    Screenshot of the top of the "Source Control" side bar. The pull request icon is highlighted with a dark orange outline.
  2. Check that the local branch and repository you're merging from, and the remote branch and repository you're merging into, are correct. Then, give the pull request a title and a description.
    Screenshot of the "GitHub Pull Request" side bar with a form for creating a pull request, including "Title" and "Description" fields.
  3. Click Create.

For more information on creating pull requests in GitHub Codespaces, see Uso de GitHub Codespaces para solicitudes de incorporación de cambios.

Making changes to files in your pull request

After you open your pull request, you can continue changing files by adding new commits to your head branch.

You can also make changes to files on the GitHub website.

  1. On GitHub, navigate to a pull request in a repository.

  2. En la solicitud de incorporación de cambios, haz clic en Archivos cambiados.

    Captura de pantalla de las pestañas de una solicitud de incorporación de cambios. La pestaña "Archivos cambiados" está resaltada en naranja oscuro.

  3. Scroll down to the file you want to make changes to.

    • If the pull request has a lot of files, you can use the filter to locate the file.

  4. Above the file you want to change, click . Screenshot of the options above a file on the "File changed" tab. The "Show options" button is highlighted with an orange rectangle.

  5. In the menu, click Edit file.

  6. Make your changes in the editor. When you commit your change, choose to commit directly back to your head branch.

Further reading