Versión del artículo: Enterprise Server 2.17
Crear de forma manual una plantilla de propuesta única para tu repositorio
Cuando agregas una plantilla de propuesta creada de forma manual a tu repositorio, los colaboradores del proyecto verán automáticamente los contenidos de la plantilla en el cuerpo de la propuesta.
Este es el flujo de trabajo tradicional para crear una plantilla de informe de problemas. Te recomendamos utilizar el creador múltiple de plantillas de informe de problemas mejorado para crear varias plantillas. Para obtener más información, consulta "Acerca de las plantillas de propuestas y solicitudes de extracción".
Puedes crear un subdirectorio de ISSUE_TEMPLATE/ (PLANTILLA DE PROPUESTA) en alguna de las carpetas admitidas para incluir múltiples plantillas de propuestas, y utilizar el parámetro de consulta template
para especificar la plantilla que completará el cuerpo de la propuesta. 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 "
Puede añadir texto preliminar de YAML a cada plantilla de reporte de problemas para pre-llenar el título del mismo, añadir etiquetas y personal asignado automáticamente, y asignar un nombre y descripción que se mostrará en el selector de la misma, el cual verán las personas cuando se cree un nuevo reporte de problemas en su repositorio.
Aquí hay un ejemplo de texto preliminar de YAML.
---
nombre: Problema de rastreo
acerca de: Utilice esta plantilla para rastrear nuevas características.
título: "[DATE]: [FEATURE NAME]"
etiquetas: problema de rastreo, necesita clasificación
asignados: octocat
---
Nota: Debes poner los -caracteres reservados de YAML tales como :
entre comillas. Por ejemplo, ":bug: Bug"
.
Puedes crear plantillas de informe de problemas predeterminadas para tu cuenta de organización. Para obtener más información, consulta "Crear un archivo de salud predeterminado para la comunidad"
Agregar una plantilla de propuesta
- 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 que tu plantilla de propuesta sea visible en el directorio raíz del repositorio, escribe el nombre de tu issue_template (plantilla de propuesta). Por ejemplo,
issue_template.md
. - Para que tu plantilla de propuesta sea visible en el directorio
docs
del repositorio, escribe docs/ seguido del nombre de tu issue_template. Por ejemplo,docs/issue_template.md
, - Para almacenar tu archivo en un directorio escondido, escribe .github/ seguido del nombre de tu issue_template. Por ejemplo,
.github/issue_template.md
. - Para crear múltiples plantillas de propuestas y utilizar el parámetro de consulta
template
para especificar una plantilla para que complete el cuerpo de la propuesta, escribe .github/ISSUE_TEMPLATE/, después el nombre de tu plantilla de propuesta. Por ejemplo,.github/ISSUE_TEMPLATE/issue_template.md
. Puedes también almacenar múltiples plantillas de propuestas en un subdirectorioISSUE_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 tu plantilla de propuesta sea visible en el directorio raíz del repositorio, escribe el nombre de tu issue_template (plantilla de propuesta). Por ejemplo,
- En el cuerpo del nuevo archivo, agrega tu plantilla de propuesta. Puede incluir:
- Texto preliminar de YAML
- Comportamiento esperado y comportamiento real
- Pasos para reproducir el problema
- Especificaciones como la versión del proyecto, el sistema operativo, o el hardware
- 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 disponibles para los colaboradores cuando están fusionadas dentro de la rama predeterminada del repositorio. - Da clic en Proponer nuevo archivo.