Creación de formularios de categoría de discusión

En este artículo

Puedes personalizar las plantillas disponibles para los miembros de la comunidad para que las utilicen cuando abran una discusión nueva en tu repositorio.

Acerca de los formularios de categoría de discusión

Puedes animar a los miembros de la comunidad para que incluyan información estructurada específica en sus discusiones usando formularios de discusión en tu repositorio. Con los formularios de categoría de discusión, puedes crear plantillas de discusión que contengan campos de formulario web personalizables. Los formularios de discusión se escriben en YAML mediante el esquema de formulario de GitHub. Para obtener más información, vea «Sintaxis para el modelado de formato de GitHub».

Si no está familiarizado con YAML y quiere obtener más información, vea "Aprenda YAML en Y minutos".

Para usar un formulario de categoría de discusión en tu repositorio, debes crear un archivo y agregarlo a la carpeta /.github/DISCUSSION_TEMPLATE/ del repositorio.

También puedes crear formularios de categoría de discusión para tu organización. Para obtener más información, vea «Creación de un archivo predeterminado de mantenimiento de la comunidad».

No se pueden usar formularios de categoría de discusión en sondeos. Para más información sobre los sondeos, consulta "Acerca de los debates".

Aquí está la versión interpretada de un formato de propuesta.

Captura de pantalla de un formulario de categoría de discusión representado.

Creación de formularios de categoría de discusión

Los usuarios con acceso de escritura a un repositorio pueden crear un formulario de categoría de discusión.

  1. Ve al repositorio donde quieras crear un formulario de categoría de discusión.
  2. En el repositorio, crea un archivo denominado /.github/DISCUSSION_TEMPLATE/FORM-NAME.yml y reemplaza FORM-NAME por el nombre del formulario de categoría de discusión. El nombre debe coincidir con el slug de una de las categorías de discusión. Por ejemplo, la plantilla de una categoría llamada "Announcements" debe ser .github/DISCUSSION_TEMPLATE/announcements.yml. Para más información sobre cómo crear archivos en GitHub, consulta "Crear nuevos archivos".
  3. Escribe el contenido del formulario de categoría de discusión en el cuerpo del nuevo archivo. Para obtener más información, vea «Sintaxis de los formularios de categoría de discusión».
  4. Confirma tu archivo en la rama predeterminada de tu repositorio. Para obtener más información, vea «Crear nuevos archivos».