Versión del artículo: Enterprise Server 2.17
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 "
Puedes crear plantillas de solicitud de extracción predeterminadas para tu organización. Para obtener más información, consulta "Crear un archivo de salud predeterminado para la comunidad"
Agregar una plantilla de solicitud de extracción
- En GitHub Enterprise, visita la página principal del repositorio.
- Arriba de la lista de archivos, da clic en Crear archivo nuevo.
- En el campo del nombre del archivo:
- Para hacer que tu plantilla de solicitud de extracción se pueda ver en el directorio raíz del repositorio, nómbrala como
pull_request_template.md
. - Para hacer que tu plantilla de solicitud de extracción se pueda ver en el directorio
docs
del repositorio, nómbrala comodocs/pull_request_template.md
. - Para guardar tu archivo en un directorio oculto, nombra la plantilla de solicitud de extracción
.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 hacer que tu plantilla de solicitud de extracción se pueda ver en el directorio raíz del repositorio, nómbrala como
- En el cuerpo del nuevo archivo, agrega tu plantilla de solicitud de extracción. Puede 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, 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 obtener más información, consulta "Crear una confirmación con co-autores múltiples".
- Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Si tu rama actual es
master
, debes escoger crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para obtener más información, consulta "Crear una solicitud de extracción nueva".Las plantillas están a disposición de los colaboradores cuando se fusionan en la rama predeterminada del repositorio. - Da clic en Proponer nuevo archivo.