Skip to main content

Esta versión de GitHub Enterprise Server se discontinuó el 2024-03-26. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener rendimiento mejorado, seguridad mejorada y nuevas características, actualice a la versión más reciente de GitHub Enterprise Server. Para obtener ayuda con la actualización, póngase en contacto con el soporte técnico de GitHub Enterprise.

Configurar las plantillas de reporte de problemas para tu repositorio

Puedes personalizar las plantillas disponibles para los colaboradores para que las utilicen cuando abren un nuevo reporte de problema en tu repositorio.

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 obtener más información, vea «Creación de un archivo predeterminado de mantenimiento de la comunidad».

Crear plantillas de reporte de problemas

  1. En tu instancia de GitHub Enterprise Server, navega a la página principal del repositorio.

  2. En el nombre del repositorio, haz clic en Configuración. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la sección "Características", en Incidencias, haz clic en Configurar plantillas. Es posible que tengas que habilitar Problemas y actualizar la página para poder ver el botón.

  4. Usa el menú desplegable Agregar plantilla y haz clic en el tipo de plantilla que deseas crear.

    Captura de pantalla del menú desplegable "Agregar plantilla" expandido para mostrar las plantillas estándar "Informe de errores" y "Solicitud de características". Además, aparece la lista "Plantilla personalizada".

  5. Para obtener una vista previa de la plantilla o editarla antes de confirmarla en el repositorio, haz clic en Vista previa y edición.

  6. Para editar la plantilla, haz clic en y escribe en los campos para editar el contenido.

    Captura de pantalla de la vista previa de una plantilla de problema. A la derecha del nombre de la plantilla, aparece un icono de lápiz en naranja oscuro.

  7. Para establecer automáticamente un título de incidencia predeterminado, asignar la incidencia a personas con acceso de lectura al repositorio o aplicar etiquetas a las incidencias planteadas desde la plantilla, utilice los campos de "Información adicional opcional". También puede agregar estos detalles en la plantilla de incidencia con title, labels o assignees en un texto preliminar de YAML.

  8. 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.

  9. En el campo "Confirmar mensaje", escribe un mensaje de confirmación que describa los cambios.

  10. Debajo de los campos del mensaje de confirmación, selecciona si deseas confirmar la plantilla directamente en la rama predeterminada o crear una nueva rama y abrir una solicitud de incorporación de cambios. Para obtener más información sobre solicitudes de incorporación de cambios, consulta "Acerca de las solicitudes de incorporación de cambios".

  11. 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.

YAML
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.

  1. En tu instancia de GitHub Enterprise Server, navega a la página principal del repositorio.

  2. Encima de la lista de archivos, haga clic en Create new file (Crear archivo) mediante la lista desplegable Add file (Agregar archivo).

  3. En el campo del nombre de archivo, escriba .github/ISSUE_TEMPLATE/config.yml.

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

  5. En el campo de "Mensaje de confirmación", escriba un mensaje de confirmación corto y significativo que describa la modificación que hizo en el archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para obtener más información, vea «Crear una confirmación con distintos autores».

  6. 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 obtener más información, vea «Crear una solicitud de incorporación de cambios».

    Captura de pantalla de una solicitud de cambios de GitHub en la que se muestra un botón de radio para confirmar directamente en la rama principal o para crear una nueva rama. Aparece seleccionada la opción de rama nueva.

  7. Haz clic en Confirmar cambios o Proponer cambios.

Cambiar el orden de las plantillas

Puede configurar el orden en el que aparecerán las plantillas de problemas en el selector de plantillas realizando cambios en los nombres de archivo de las plantillas. Las plantillas de .github/ISSUE_TEMPLATE se enumeran alfanuméricamente y se agrupan por tipo de archivo, con archivos YAML que aparecen antes de los archivos Markdown.

Para controlar el orden de las plantillas, debe añadir un prefijo de número a los nombres de archivo. Por ejemplo, 1-bug.yml, 2-feature-request.yml y 3-epic.yml.

Si tiene 10 o más plantillas, la ordenación alfanumérica significa que 11-bug.yml se colocará entre 1-feature.yml y 2-support.yml. Puede mantener el orden previsto añadiendo un prefijo a los nombres de archivo numéricos con un 0 adicional. Por ejemplo, 01-feature.yml, 02-support.yml y 11-bug.yml.

Información adicional