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".
Crear plantillas de reporte de problemas
- En your GitHub Enterprise Server instance, vaya a la página principal del repositorio. 1. Debajo del nombre del repositorio, haz clic en Configuración.
- En la sección "Características", en "Incidencias", haga clic en Configurar plantillas.
- Usa el menú desplegable Agregar plantilla y haz clic en el tipo de plantilla que deseas crear.
- Para obtener una vista previa de la plantilla o editarla antes de confirmarla en el repositorio, haga clic en Vista previa y edición.
- Para editar la plantilla, haga clic en y escriba en los campos para editar el contenido.
- Para establecer automáticamente un título predeterminado para la propuesta, asigna la propuesta a personas que tengan acceso de lectura al repositorio o aplica etiquetas a tu plantilla de propuesta e ingresa estos detalles en "Información adicional opcional". También puede agregar estos detalles en la plantilla de incidencia con
title
,labels
oassignees
en un texto preliminar de YAML. - Cuando haya terminado de editar y ver la vista previa de la plantilla, haga clic en Proponer cambios en la esquina superior derecha de la página.
- Escribe un mensaje de confirmación que describa los cambios que realizaste.
- Debajo de los campos del mensaje de confirmación, decide si deseas confirmar tu plantilla directamente en la rama predeterminada o si deseas crear una nueva rama y abrir una solicitud de extracción. Para más información sobre las solicitudes de incorporación de cambios, vea "Acerca de las solicitudes de incorporación de cambios".
- Haga clic en Confirmar cambios. Una vez que estos cambios se fusionen en la rama predeterminada, la plantilla estará disponible para que la usen los colaboradores cuando abran nuevas propuestas en el repositorio.
Configurar el selector de plantillas
Puede personalizar el selector de plantillas de incidencia que ven los usuarios al crear una incidencia en el repositorio si agrega un archivo config.yml a la carpeta .github/ISSUE_TEMPLATE
.
Puede animar a los colaboradores a usar plantillas de incidencia si establece blank_issues_enabled
en false
. Si establece blank_issues_enabled
en true
, los usuarios tendrán la opción de abrir una incidencia en blanco.
Nota: Si ha usado el flujo de trabajo heredado para crear manualmente un archivo issue_template.md
en la carpeta .github
y habilita las incidencias en blanco en el archivo config.yml, se utilizará la plantilla de issue_template.md
cuando los usuarios decidan abrir una incidencia en blanco. Si inhabilitas los reportes de problemas en blanco, la plantilla nunca se utilizará.
Si prefiere recibir determinados informes fuera de GitHub Enterprise Server, puede dirigir a los usuarios a sitios externos con contact_links
.
Este es un archivo config.yml de ejemplo.
blank_issues_enabled: false
contact_links:
- name: GitHub Community Support
url: https://github.com/orgs/community/discussions
about: Please ask and answer questions here.
- name: GitHub Security Bug Bounty
url: https://bounty.github.com/
about: Please report security vulnerabilities here.
Tu archivo de configuración personalizará el selector de plantilla cuando el archivo se combina en la rama predeterminada del repositorio.
- 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 del nombre de archivo, escriba
.github/ISSUE_TEMPLATE/config.yml
. - Teclea el contenido de tu archivo de configuración en el cuerpo del nuevo archivo. 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". 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". 1. Haga clic en Proponer nuevo archivo.