Créer des formulaires de catégorie de discussion

Vous pouvez personnaliser les modèles que les membres de la communauté peuvent utiliser pour ouvrir de nouvelles discussions dans votre dépôt.

Dans cet article

À propos des formulaires de catégorie de discussion

Vous pouvez encourager les membres de la communauté à inclure des informations spécifiques et structurées dans leurs discussions en utilisant des formulaires de discussion dans votre dépôt. Avec les formulaires de catégorie de discussion, vous pouvez créer des modèles de discussion qui ont des champs de formulaire web personnalisables. Les formulaires de discussion sont écrits en YAML à l’aide du schéma de formulaire GitHub. Pour plus d’informations, consultez « Syntaxe du schéma de formulaire de GitHub ».

Si vous débutez avec YAML et souhaitez en savoir plus, consultez « Découvrir YAML en Y minutes ».

Pour utiliser un formulaire de catégorie de discussion dans votre dépôt, vous devez créer un fichier et l’ajouter au dossier /.github/DISCUSSION_TEMPLATE/ de votre dépôt.

Vous pouvez également créer des formulaires de catégorie de discussion pour votre organisation. Pour plus d’informations, consultez « Création d’un fichier d’intégrité de la communauté par défaut ».

Les formulaires de catégorie de discussion ne sont pas pris en charge pour les sondages. Pour plus d’informations sur les sondages, consultez « À propos des discussions ».

Voici la version affichée du formulaire de problème.

Capture d’écran de l’affichage d’un formulaire de catégorie de discussion.

Créer des formulaires de catégorie de discussion

Les personnes disposant d’un accès en écriture à un dépôt peuvent créer un formulaire de catégorie de discussion.

  1. Accédez au dépôt dans lequel vous souhaitez créer un formulaire de catégorie de discussion.
  2. Dans votre dépôt, créez un fichier appelé /.github/DISCUSSION_TEMPLATE/FORM-NAME.yml, en remplaçant FORM-NAME par le nom de votre formulaire de catégorie de discussion. Le nom doit correspondre au slug de l’une de vos catégories de discussion. Par exemple, le modèle pour la catégorie « Announcements » doit être .github/DISCUSSION_TEMPLATE/announcements.yml. Pour plus d’informations sur la création de fichiers sur GitHub, consultez « Création de fichiers ».
  3. Dans le corps du nouveau fichier, tapez le contenu de votre formulaire de catégorie de discussion. Pour plus d’informations, consultez « Syntaxe des formulaires de catégorie de discussion ».
  4. Commitez votre fichier dans la branche par défaut de votre dépôt. Pour plus d’informations, consultez « Création de fichiers ».