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.

Crear de forma manual una plantilla de propuesta única para tu repositorio

Cuando agregas una plantilla de propuesta creada de forma manual a tu repositorio, los colaboradores del proyecto verán automáticamente los contenidos de la plantilla en el cuerpo de la propuesta.

En este artículo

This is the legacy workflow to create an issue template. We recommend using the upgraded multiple issue template builder to create multiple issue templates. Para obtener más información, consulta "Acerca de las plantillas de propuestas y solicitudes de extracción".

Puedes crear un subdirectorio de ISSUE_TEMPLATE/ (PLANTILLA DE PROPUESTA) en alguna de las carpetas admitidas para incluir múltiples plantillas de propuestas, y utilizar el parámetro de consulta template para especificar la plantilla que completará el cuerpo de la propuesta. Para obtener más información, consulta "Acerca de la automatización para las propuestas y las solicitudes de extracción con parámetros de consulta "

You can add YAML frontmatter to each issue template to pre-fill the issue title, automatically add labels and assignees, and give the template a name and description that will be shown in the template chooser that people see when creating a new issue in your repository.

Here is example YAML front matter.

---
name: Tracking issue
about: Use this template for tracking new features.
title: "[DATE]: [FEATURE NAME]"
labels: tracking issue, needs triage
assignees: octocat, octo-org/octo-team
---

Note: You must put YAML-reserved characters such as : in quotes. For example, ":bug: Bug".

To be included in the community profile checklist, issue templates must be located in the .github/ISSUE_TEMPLATE folder and contain valid name: and about: YAML front matter.

You can create default issue templates and a default configuration file for issue templates for your organization. Para más información, consulta "Crear un archivo de estado de comunidad predeterminado para tu organización".

Agregar una plantilla de propuesta

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

  2. Above the file list, click Create new file.

    The New file button

  3. En el campo del nombre del archivo:

    • Para que tu plantilla de propuesta sea visible en el directorio raíz del repositorio, escribe el nombre de tu issue_template (plantilla de propuesta). Por ejemplo, issue_template.md.
      Nuevo nombre de la plantilla de propuesta en un directorio raíz
    • Para que tu plantilla de propuesta sea visible en el directorio docs del repositorio, escribe docs/ seguido del nombre de tu issue_template. Por ejemplo, docs/issue_template.md,
      Nueva plantilla de propuesta en el directorio docs
    • Para almacenar tu archivo en un directorio escondido, escribe .github/ seguido del nombre de tu issue_template. Por ejemplo, .github/issue_template.md.
      Nueva plantilla de propuesta en un directorio oculto
    • Para crear múltiples plantillas de propuestas y utilizar el parámetro de consulta template para especificar una plantilla para que complete el cuerpo de la propuesta, escribe .github/ISSUE_TEMPLATE/, después el nombre de tu plantilla de propuesta. Por ejemplo, .github/ISSUE_TEMPLATE/issue_template.md. Puedes también almacenar múltiples plantillas de propuestas en un subdirectorio ISSUE_TEMPLATE dentro de la raíz o directorios docs/. Para obtener más información, consulta "Acerca de la automatización para las propuestas y las solicitudes de extracción con parámetros de consulta "
      Nueva plantilla de propuesta múltiple en un directorio oculto
  4. En el cuerpo del nuevo archivo, agrega tu plantilla de propuesta. Puede incluir:

    • YAML frontmatter
    • Comportamiento esperado y comportamiento real
    • Pasos para reproducir el problema
    • Especificaciones como la versión del proyecto, el sistema operativo, o el hardware
  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 Las plantillas están disponibles para los colaboradores cuando están fusionadas dentro de la rama predeterminada del repositorio.

  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