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

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

En este artículo

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 más información, consulta Sintaxis para el modelado de formato de GitHub.

Si no tienes experiencia con YAML y quieres obtener más información, consulta Aprende YAML en Y minutos.

Para usar un formulario de categoría de discusión en el 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 más información, consulta 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 más información, consulta Sintaxis de los formularios de categoría de discusión.
  4. Confirma tu archivo en la rama predeterminada de tu repositorio. Para más información, consulta Crear nuevos archivos.