Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

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.

Nota: Los formularios de categoría de debate actualmente están en versión beta pública limitada y están sujetos a cambios.

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, vea "Sintaxis del esquema de formulario para 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 más información, vea "Creación de un archivo de estado de la comunidad predeterminado".

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

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 obtener más información sobre cómo crear archivos en GitHub, consulta Creación de 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, 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, vea "Creación de archivos".