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 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 Server, visita la página principal del repositorio.
  2. Debajo de tu nombre de repositorio, da clic en Configuración. Botón de configuración del repositorio
  3. En la sección "Características", en "Propuestas", haz clic en Configurar plantillas. Botón Start template setup (Comenzar la configuración de plantilla)
  4. Usa el menú desplegable Agregar plantilla y haz clic en el tipo de plantilla que deseas crear. Menú desplegable Agregar plantilla
  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. Botón para mostrar la vista previa y editar
  6. Para editar la plantilla, haz clic en y escribe en los campos para editar el contenido. Botón Issue template edit (Editar plantilla de propuesta)
  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. Información adicional de plantilla de propuesta
  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. Botón para proponer cambios
  9. Escribe un mensaje de confirmación que describa los cambios que realizaste. Campo para el mensaje de confirmación de la plantilla de propuesta
  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". Elecciòn de la plantilla de propuesta para mantener o abrir una solicitud de cambios
  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.

Nota:Si utilizaste el flujo de trabajo tradicional para crear un archivo de issue_template.md manualmente en la carpeta de .github y habilitar así las propuestas en blanco en tu archivo de config.yml, la plantilla en el archivo issue_template.md se utilizará cuando las personas decidan abrir una propuesta en blanco. Si inhabilitas los reportes de problemas en blanco, la plantilla nunca se utilizará.

Si prefieres recibir ciertos reportes fuera de GitHub Enterprise Server, 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 Server, visita la página principal del repositorio.
  2. En la parte superior de la lista de archivos, utilizando el menú desplegable de Agregar archivo, da clic en Crear archivo nuevo. "Crear archivo nuevo" en el menú desplegable de "Agregar archivo"
  3. Teclea .github/ISSUE_TEMPLATE/config.yml en el campo de nombre de archivo. Nombre de archivo de configuración
  4. Teclea el contenido de tu archivo de configuración en el cuerpo del nuevo archivo. Contenido de archivo de configuración
  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". Mensaje de confirmación de tu cambio
  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". Confirmar opciones de rama
  7. Da clic en Proponer nuevo archivo. Botón para proponer nuevo archivo

Leer más

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.