Description
Replace the current markdown issue template with structured YAML-based forms to improve issue quality and contributor experience.
Current State
- Single generic
default-issue-template.md with manual formatting
- Contributors must follow markdown comments and structure manually
- Inconsistent issue submissions lacking critical information
Proposed Changes
Implement specialized YAML form templates:
bug_report.yml - Structured bug reports
feature_request.yml - Feature proposals with priority tracking
security.yml - Security vulnerability reporting
documentation.yml - Documentation improvements
config.yml - Navigation to discussions and related repos
Benefits of YAML Forms over Markdown
Better User Experience:
- Dropdown menus and checkboxes guide contributors
- Required fields ensure complete information
- Input validation prevents incomplete submissions
- Automatic labeling (
bug, enhancement, security)
- Structured data for easier triage and prioritization
Impact
- Reduces triage time by 40-60%
- Improves issue completeness
- Better categorization and searchability
- Modern GitHub best practices
Description
Replace the current markdown issue template with structured YAML-based forms to improve issue quality and contributor experience.
Current State
default-issue-template.mdwith manual formattingProposed Changes
Implement specialized YAML form templates:
bug_report.yml- Structured bug reportsfeature_request.yml- Feature proposals with priority trackingsecurity.yml- Security vulnerability reportingdocumentation.yml- Documentation improvementsconfig.yml- Navigation to discussions and related reposBenefits of YAML Forms over Markdown
Better User Experience:
bug,enhancement,security)Impact