Skip to main content

Creating a pull request template for your repository

When you add a pull request template to your repository, project contributors will automatically see the template's contents in the pull request body.

For more information, see "About issue and pull request templates."

You can create a PULL_REQUEST_TEMPLATE/ subdirectory in any of the supported folders to contain multiple pull request templates, and use the template query parameter to specify the template that will fill the pull request body. For more information, see "Using query parameters to create a pull request."

You can create default pull request templates for your organization or personal account. For more information, see "Creating a default community health file."

Adding a pull request template

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.
  2. Encima de la lista de archivos, haga clic en Create new file (Crear archivo) mediante la lista desplegable Add file (Agregar archivo). "Crear archivo" en la lista desplegable "Agregar archivo"
  3. In the file name field:
    • To make your pull request template visible in the repository's root directory, name the pull request template pull_request_template.md. New pull request template name in root directory
    • To make your pull request template visible in the repository's docs directory, name the pull request template docs/pull_request_template.md. New pull request template in docs directory
    • To store your file in a hidden directory, name the pull request template .github/pull_request_template.md. New pull request template in hidden directory
    • To create multiple pull request templates and use the template query parameter to specify a template to fill the pull request body, type .github/PULL_REQUEST_TEMPLATE/, then the name of your pull request template. For example, .github/PULL_REQUEST_TEMPLATE/pull_request_template.md. You can also store multiple pull request templates in a PULL_REQUEST_TEMPLATE subdirectory within the root or docs/ directories. For more information, see "Using query parameters to create a pull request." New multiple pull request template in hidden directory
  4. In the body of the new file, add your pull request template. This could include:
    • A reference to a related issue in your repository.
    • A description of the changes proposed in the pull request.
    • @mentions of the person or team responsible for reviewing proposed changes.
  5. En la parte inferior de la página, teclea un mensaje de confirmación corto y significativo que describa el cambio que realizaste al archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para más información, vea "Creación de una confirmación con varios coautores". Mensaje de confirmación para el cambio
  6. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para más información, vea "Creación de una solicitud de incorporación de cambios". Opciones de confirmación de rama Templates are available to collaborators when they are merged into the repository's default branch.
  7. Haga clic en Proponer nuevo archivo. Botón para proponer un nuevo archivo

Further reading