Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.
Versión del artículo: GitHub.com

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.

En este artículo

You can create default issue templates and a default configuration file for issue templates for your organization or user account. For more information, see "Creating a default community health file."

Crear plantillas de reporte de problemas

  1. En GitHub, visita la página principal del repositorio.
  2. Under your repository name, click Settings.
    Repository settings button
  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".
    Confirmar la plantilla de propuesta al repositorio principal u opción de abrir una solicitud 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

You can customize the issue template chooser that people see when creating a new issue in your repository by adding a config.yml file to the .github/ISSUE_TEMPLATE folder.

Puedes solicitar que los colaboradores utilicen plantillas de reporte de problemas si configuras 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, 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: Foro 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, visita la página principal del repositorio.
  2. Above the file list, click Create new file.
    The New file button
  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. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."
    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. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."
    Confirmar opciones de rama
  7. Click Propose new file.
    Propose new file button

Leer más

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos