fix(discussions): repair discussion form schema\n\nProblem\n- GitHub Discussions rejected the templates on this branch because the form files used invalid top-level keys such as and \n- Several template filenames also did not match the actual discussion category slugs\n\nChange\n- replace invalid top-level keys with supported discussion form keys\n- rename templates to match category slugs and drop the unmatched extra template\n- update the template README to document the valid mapping\n\nAuthored by OpenClaw (model: gpt-5.4)

njzjz-bot · njzjz-bot · commit 79f150cf163b · 2026-04-07T17:00:10.000Z
diff --git a/.github/DISCUSSION_TEMPLATE/README.md b/.github/DISCUSSION_TEMPLATE/README.md
@@ -1,44 +1,15 @@
 # Discussion Templates
 
-This directory contains GitHub Discussion templates for the DeePMD-kit repository. These templates help guide users to provide comprehensive information when starting discussions, particularly emphasizing the importance of reproducible examples.
+This directory contains GitHub Discussion category forms for DeePMD-kit.
 
-## Available Templates
+## Active templates
 
-### 1. General Question (`general-question.yml`)
-For general questions about DeePMD-kit usage, features, or concepts. Use this when you have a straightforward question that doesn't require extensive troubleshooting.
+- `general.yml` → **General**
+- `q-a.yml` → **Q&A**
+- `ideas.yml` → **Ideas**
+- `show-and-tell.yml` → **Show and tell**
 
-### 2. Usage Help (`usage-help.yml`)
-For detailed help with specific DeePMD-kit usage scenarios. **This template strongly emphasizes providing reproducible examples** to help community members provide effective assistance.
+## Notes
 
-### 3. Ideas and Suggestions (`ideas-suggestions.yml`)
-For proposing new features, improvements, or enhancements to DeePMD-kit. Includes sections for use cases, related work, and implementation thoughts.
-
-### 4. Show and Tell (`show-and-tell.yml`)
-For sharing projects, research, or achievements using DeePMD-kit. Encourages sharing reproducible information and lessons learned.
-
-### 5. Potential Bug Discussion (`potential-bug.yml`)
-For discussing behavior that might be a bug before creating a formal issue. **Emphasizes providing complete reproducible examples** to help confirm whether the behavior is indeed a bug.
-
-## Key Features
-
-All templates are designed to:
-- **Encourage reproducible examples**: Each template emphasizes the importance of providing complete, minimal examples that others can reproduce
-- Follow the repository's existing style and conventions
-- Include appropriate labels for categorization
-- Provide clear guidance on what information to include
-- Help users structure their discussions effectively
-
-## Usage
-
-When users start a new discussion, they will be presented with these template options. The templates guide them to provide:
-
-- Clear problem descriptions
-- Version information
-- Reproducible examples with:
-  - Input files
-  - Configuration files
-  - Commands run
-  - Expected vs actual behavior
-  - Complete error messages
-
-This addresses the issue mentioned in #4506 where "many discussions do not give reproduced examples."
+GitHub Discussion form filenames must match the target discussion category slug exactly.
+Top-level keys allowed by GitHub are limited; use `title`, `labels`, and `body`.
diff --git a/.github/DISCUSSION_TEMPLATE/general.yml b/.github/DISCUSSION_TEMPLATE/general.yml
@@ -1,5 +1,4 @@
-name: Usage Help
-description: Get help with using DeePMD-kit - provide reproducible examples for the best assistance
+title: "[General] "
 labels: ["help wanted", "usage"]
 body:
   - type: textarea
diff --git a/.github/DISCUSSION_TEMPLATE/ideas.yml b/.github/DISCUSSION_TEMPLATE/ideas.yml
@@ -1,5 +1,4 @@
-name: Ideas and Suggestions
-description: Share ideas for new features, improvements, or enhancements to DeePMD-kit
+title: "[Ideas] "
 labels: ["idea", "enhancement"]
 body:
   - type: textarea
diff --git a/.github/DISCUSSION_TEMPLATE/potential-bug.yml b/.github/DISCUSSION_TEMPLATE/potential-bug.yml
diff --git a/.github/DISCUSSION_TEMPLATE/q-a.yml b/.github/DISCUSSION_TEMPLATE/q-a.yml
@@ -1,5 +1,4 @@
-name: General Question
-description: Ask a general question about DeePMD-kit usage, features, or concepts
+title: "[Q&A] "
 labels: ["question"]
 body:
   - type: textarea
diff --git a/.github/DISCUSSION_TEMPLATE/show-and-tell.yml b/.github/DISCUSSION_TEMPLATE/show-and-tell.yml
@@ -1,5 +1,4 @@
-name: Show and Tell
-description: Share your projects, research, or achievements using DeePMD-kit
+title: "[Show and tell] "
 labels: ["show and tell"]
 body:
   - type: textarea
