Configurar las plantillas de reporte de problemas para tu repositorio

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

1. En GitHub Enterprise, visita la página principal del repositorio.
2. Debajo de tu nombre de repositorio, da clic en Configuración.
   
3. En la sección "Características", en "Propuestas", haz clic en Configurar plantillas.
   
4. Usa el menú desplegable Agregar plantilla y haz clic en el tipo de plantilla que deseas crear.
   
5. 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.
   
6. Para editar la plantilla, haz clic en y escribe en los campos para editar el contenido.
   
7. 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 o asignatario en un formato de texto preliminar en lenguaje YAML.
   
8. 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.
   
9. Escribe un mensaje de confirmación que describa los cambios que realizaste.
   
10. 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".
    
11. 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.

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.

1. En GitHub Enterprise, visita la página principal del repositorio.

2. Sobre la lista de archivos, da clic en Crear archivo nuevo.

   

3. Teclea .github/ISSUE_TEMPLATE/config.yml en el campo de nombre de archivo.

   

4. Teclea el contenido de tu archivo de configuración en el cuerpo del nuevo archivo.

   

5. 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".

   

6. 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".

   

7. Da clic en Proponer nuevo archivo.

   

Leer más

• "Acerca de las plantillas de propuestas y de solicitudes de extracción"
• "Crear de forma manual una plantilla de propuesta única para tu repositorio"