We need a new issue template for reporting bug related issues
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 231
- Forks
- 24
- Avg merge
- 2d 5h
- Merged PRs (30d)
- 3
Description
[!IMPORTANT]
This has taken me a while to write (over an hour) and definitely not how I wanted to spend my weekend so keep in mind with me that I am doing my best within my own mental capacity to explain this problem.
I'm having trouble coming up with a proper issue template from a .yaml file extension due to the vagueness and wording of the documentation but here is some examples of what I am expecting to see more of in the future:
-
Bad Examples:
Know that In the future issues like these should be discarded.- #101
- #11
-
Good Examples:
These kinds of issues should be more encouraged as they are straight forward reports without being vague as to what the problem is.- #84
- #59
- #12
The Rules going forward should be simple practice and common sense for anybody to understand
We need a template that Acknowledges these important key rules
- Disallowing AI/LLM Generated issues or code and closing/terminating these issues if or when found along with labeling a tag titled AI Generated or AI
- Acknowledge that duplicate issues will be redirected and promptly discarded.
- Acknowledge that vague reproducers may result in not being able to do anything or even having the issue being closed or terminated.
- Acknowledge that reproducers should be text and not partial code snippets or screenshots and that no closed source code for reproducers should be allowed period
- Acknowledge that if a problem or bug is not related to winloop that it will be labeled as being an
external-library's-faultand possibly may be reviewed on weather or not to close or redirect the issue to that external library's repo. - Encourage Users to write a description of the bug being faced although have it be a completely optional thing.
Something like this .yaml configuration is what I'm aiming for but currently I don't understand it.
name: Report Bug with winloop
description: Report an issue with winloop
body:
- type: markdown
attributes:
value: |
> [!IMPORTANT]
> Ensure you have agreed to these terms before throwing an issue
- type: checkboxes
id: checklist
attributes:
label: Checklist
description: |
Carefully read and checkmark all the terms and conditions before
continuing with reporting the issue
options:
- label: I am not a kindergartener and that creating AI generated code or grammar of any sort
will result in my issue being terminated, promptly closed and labeled as **AI**
required: true
- label: If there was already an issue about this that hasn't been closed at all
your issue will be treated and duplicate and closed
required: true
- label: If I do not have a code snippet or can't reproduce the bug to the issue I'm
experiencing to best of my own abilities then the issue will be ignored.
required: true
- label: If something is caused by a dependency that is unrelated to winloop
my issue will be labeled under **external library's fault** and that I will be redirected
to throwing the issue with the external library's issue page
required: true
- lablel: If my code is incomplete it will be marked as **reproducer vauge** and that I will need
to go back and redo my reproducable bug.
required: true
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing GitHub issue form syntax and the repository's existing .github/ISSUE_TEMPLATE files, if present. Create a bug-report YAML template covering the requested acknowledgements and reporting fields, then validate that the form renders and its required checkboxes behave as intended.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github, yaml
- Domain
- documentation, tooling
- Issue type
- Feature
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100