-
Notifications
You must be signed in to change notification settings - Fork 1
Add 2 issue templates #1
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Add 2 issue templates #1
Conversation
Reviewer's Guide by SourceryThis pull request introduces two new issue templates to the repository: one for bug reports and another for feature requests. These templates provide a structured format for users to submit issues, ensuring that all necessary information is included. The templates are written in YAML format and include fields for describing the issue, steps to reproduce, expected behavior, and other relevant details. No diagrams generated as the changes look simple and do not need a visual representation. File-Level Changes
Tips and commandsInteracting with Sourcery
Customizing Your ExperienceAccess your dashboard to:
Getting Help
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We have skipped reviewing this pull request. It seems to have been created by a bot (hey, gitauto-ai[bot]!). We assume it knows what it's doing!
Why is this feature needed?
Adding standardized issue templates helps improve issue quality by guiding users to provide all the necessary information when reporting bugs or suggesting new features. This makes it easier for maintainers to triage, reproduce, and address reported issues efficiently, while also ensuring that contributors know exactly what information to provide.
What and how are we changing? Why this approach?
• Two new issue templates have been added to the repository:
By using structured YAML files for these templates, GitHub’s new issue creation interface can automatically prompt users to supply complete information. This approach minimizes the back-and-forth communication needed to gather details during issue triaging.
What actions are required from users?
• No immediate action is required from current contributors.
• When creating a new issue, users will see an option to choose between the bug report and feature request templates, ensuring they provide the necessary details from the start.
• Users are encouraged to update their issue submissions with as much detail as possible to help maintainers address problems quickly.
How does it work? (Technical details)
• The two YAML files under the .github/ISSUE_TEMPLATE directory define the structure and required fields for each issue type.
• Each template specifies field labels, descriptions, placeholders, and validations to ensure the submitted information is both complete and relevant.
• When a user clicks on “New Issue” in GitHub, these templates will be detected and offered as options, letting the user pick the appropriate template based on their needs.
Is it backwards compatible?
Yes, these changes only add new issue templates and do not affect any existing functionality or issues. Users who choose not to use a template will still be able to create issues as before.
Any other considerations?
• Future improvements may include revising fields or adding more templates based on user feedback.
• Maintainers should periodically review the submitted issues to ensure the templates continue to meet the team’s needs.
• With clear guidelines now in place, the overall quality of issue tracking is expected to improve, leading to more efficient debugging and feature implementation processes.