Crear una plantilla de solicitud de extracción para tu repositorio
Cuando agregas una plantilla de solicitud de extracción a tu repositorio, los colaboradores del proyecto verán automáticamente los contenidos de la plantilla en el cuerpo de la solicitud de extracción.
Para obtener más información, consulta "Acerca de las plantillas de propuestas y solicitudes de extracción".
Puedes crear un subdirectorio PULL_REQUEST_TEMPLATE/ en alguna de las carpetas admitidas para incluir múltiples plantillas de solicitudes de extracción, y utilizar el parámetro de consulta template
para especificar la plantilla que completará el cuerpo de la solicitud de extracción. Para obtener más información, consulta "Acerca de la automatización para las propuestas y las solicitudes de extracción con parámetros de consulta "
Agregar una plantilla de solicitud de extracción
-
En GitHub Enterprise, visita la página principal del repositorio.
-
Sobre la lista de archivos, haz clic en Crear nuevo archivo.
-
En el campo para el nombre del archivo:
- Para que tus plantillas de solicitud de extracción sean visibles en el directorio raíz del repositorio, escribe el nombre de tu plantilla de solicitud de extracción. Por ejemplo,
pull_request_template.md
. - Para que tus plantillas de solicitud de extracción sean visibles en el directorio
docs
del repositorio, escribe docs y luego el nombre de tu plantilla de solicitud de extracción. Por ejemplo,docs/pull_request_template.md
. - Para almacenar tu archivo en un directorio escondido, escribe .github/ seguido del nombre de tu plantilla de solicitud de extracción. Por ejemplo,
.github/pull_request_template.md
. - Para crear plantillas de solicitud de extracción múltiples y utilizar el parámetro de consulta
template
para especificar una plantilla para completar el cuerpo de la solicitud de extracción, escribe .github/PULL_REQUEST_TEMPLATE/ y luego, el nombre de tu plantilla de solicitud de extracción. Por ejemplo,.github/PULL_REQUEST_TEMPLATE/pull_request_template.md
. También puedes almacenar plantillas de solicitud de extracción múltiples en un subdirectorioPULL_REQUEST_TEMPLATE
dentro de la raíz o directoriosdocs/
. Para obtener más información, consulta "Acerca de la automatización para las propuestas y las solicitudes de extracción con parámetros de consulta ".
- Para que tus plantillas de solicitud de extracción sean visibles en el directorio raíz del repositorio, escribe el nombre de tu plantilla de solicitud de extracción. Por ejemplo,
-
En el cuerpo del nuevo archivo, agrega tu plantilla de solicitud de extracción. Esta podría incluir:
- Una referencia a una propuesta relacionada en tu repositorio.
- Una descripción de los cambios propuestos en la solicitud de extracción.
- @menciones de la persona o del equipo responsable de revisar los cambios propuestos.
-
En la parte inferior de la página, escribe un mensaje de confirmación breve y significativo que describa el cambio que has realizado en el archivo. Puedes atribuir la confirmación a más de un autor en el mensaje de confirmación. Para obtener más información, consulta "Crear una confirmación con distintos coautores."
-
Debajo de los campos para los mensajes de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es
master
, debes elegir crear una nueva rama para tu confirmación y luego crear una solicitud de extracción.Templates are available to collaborators when they are merged into the repository's default branch. -
Haz clic en Proponer nuevo archivo.