Este es el flujo de trabajo tradicional para crear una plantilla de informe de problemas. Te recomendamos utilizar el constructor de plantillas de propuesta múltiples mejorado o emitir formatos para crear plantillas de propuestas. Para más información, vea "Acerca de las plantillas de incidencias y solicitudes de incorporación de cambios".
Puede crear un subdirectorio de ISSUE_TEMPLATE/ en cualquiera de las carpetas admitidas para incluir múltiples plantillas de incidencia y usar el parámetro de consulta template
para especificar la plantilla que rellenará el cuerpo de la incidencia. Para más información, vea "Acerca de la automatización para incidencias y solicitudes de incorporación de cambios 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.
---
name: Tracking issue
about: Use this template for tracking new features.
title: "[DATE]: [FEATURE NAME]"
labels: tracking issue, needs triage
assignees: octocat
---
Nota: Si un valor del texto preliminar incluye algún carácter reservado de YAML como :
, tendrá que incluir ese valor entre comillas. Por ejemplo, ":bug: Bug"
o ":new: triage needed, :bug: bug"
.
Puedes crear plantillas de incidencias predeterminadas y un archivo de configuración predeterminado para este tipo de plantillas para tu organización o cuenta personal. Para más información, vea "Creación de un archivo de estado de la comunidad predeterminado".
Agregar una plantilla de propuesta
- En your GitHub Enterprise Server instance, vaya a la página principal del repositorio. 1. Encima de la lista de archivos, haga clic en Create new file (Crear archivo) mediante la lista desplegable Add file (Agregar archivo).
- En el campo para el nombre del archivo:
- Para que la plantilla de incidencia sea visible en el directorio raíz del repositorio, escriba el nombre de la plantilla_de_incidencia. Por ejemplo,
issue_template.md
. - Para que la plantilla de incidencia sea visible en el directorio
docs
del repositorio, escriba docs/ seguido del nombre de la plantilla_de_incidencia. Por ejemplo,docs/issue_template.md
, - Para almacenar el archivo en un directorio oculto, escriba .github/ seguido del nombre de la plantilla_de_incidencia. Por ejemplo,
.github/issue_template.md
. - Para crear varias plantillas de incidencia y usar el parámetro de consulta
template
a fin de especificar una plantilla para rellenar el cuerpo de la incidencia, escriba .github/PLANTILLA_DE_INCIDENCIA/ y después el nombre de la plantilla de incidencia. Por ejemplo,.github/ISSUE_TEMPLATE/issue_template.md
. También puede almacenar varias plantillas de incidencia en un subdirectorioISSUE_TEMPLATE
dentro de los directorios raíz odocs/
. Para más información, vea "Acerca de la automatización para incidencias y solicitudes de incorporación de cambios con parámetros de consulta".
- Para que la plantilla de incidencia sea visible en el directorio raíz del repositorio, escriba el nombre de la plantilla_de_incidencia. Por ejemplo,
- En el cuerpo del nuevo archivo, agrega tu plantilla de propuesta. Puede incluir:
1. 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". Las plantillas están disponibles para los colaboradores cuando se combinan dentro de la rama predeterminada del repositorio.- 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 1. 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](/articles/creating-a-commit-with-multiple-authors)".
- Haga clic en Proponer nuevo archivo.
Información adicional
- "Acerca de las plantillas de incidencias y las solicitudes de incorporación de cambios"
- "Configuración de las plantillas de incidencia para el repositorio"
- "Acerca de la automatización para incidencias y solicitudes de incorporación de cambios con parámetros de consulta"
- "Creación de una incidencia"