Puedes crear plantillas de informe de problemas predeterminadas y un archivo de configuración predeterminado para éstas para tu cuenta de organización o de usuario. Para obtener más información, consulta "Crear un archivo de salud predeterminado para la comunidad"
Crear plantillas de reporte de problemas
- En GitHub Enterprise, visita la página principal del repositorio.
- Debajo de tu nombre de repositorio, da clic en Configuración.
- En la sección "Características", en "Propuestas", haz clic en Configurar plantillas.
- Usa el menú desplegable Agregar plantilla y haz clic en el tipo de plantilla que deseas crear.
- Para acceder a la vista previa o editar la plantilla antes de confirmarla en el repositorio, haz clic en Mostrar la vista previa y editar.
- Para editar la plantilla, haz clic en y escribe 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 puedes agregar estos detalles en la plantilla de propuesta con
título
,etiquetas
oasignatario
en un formato de texto preliminar en lenguaje YAML. - Cuando hayas terminado de editar y visualizar la vista previa de tu plantilla, haz clic en Proponer cambios en el ángulo superior derecho 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 obtener más información acerca de las solicitudes de extracción, consulta "Acerca de las solicitudes de extracción".
- Haz clic en Commit changes (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
Puedes personalizar el selector de plantilla de informe de problemas que ven las personas cuando crean un nuevo informe de problemas en tu repositorio si añades un archivo config.yml a la carpeta .github/ISSUE_TEMPLATE
.
Puedes alentar a los colaboradores para que utilicen plantillas de informe de problemas si configuras el parámetro blank_issues_enabled
como false
. Si configuras blank_issues_enabled
como true
, las personas podrán abrir un reporte de problema en blanco.
Nota: Si utilizaste tu flujo de trabajo tradicional para crear manualmente un archivo de issue_template.md
fy habilitaste el reporte de problemas en blanco en tu archivo de config.yml se utilizará la plantilla en issue_template.md
cuando las personas decidan abrir un reporte de problema en blanco. Si inhabilitas los reportes de problemas en blanco, la plantilla nunca se utilizará.
Si prefieres recibir ciertos reportes fuera de GitHub Enterprise, puedes dirigir a las personas a sitios externos con contact_links
.
Aquí hay un ejemplo del archivo config.yml.
blank_issues_enabled: false
contact_links:
- name: Soporte de la Comunidad de GitHub
url: https://github.community/
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 GitHub Enterprise, visita la página principal del repositorio.
-
Sobre la lista de archivos, da clic en Crear archivo nuevo.
-
Teclea
.github/ISSUE_TEMPLATE/config.yml
en el campo de nombre de archivo. -
Teclea el contenido de tu archivo de configuración en el cuerpo del nuevo archivo.
-
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 la rama predeterminada, debes elegir 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".
-
Da clic en Proponer nuevo archivo.