Issues — Let's Report & Enhance!¶
Note
- Issues section is for reporting urgent bugs or feature requests
- Further reading: Github Docs of Issues
Scenarios of Filing Issues¶
- Bugs reports
- Feature proposals
- Documentation errors reports
-
Non-Urgent Questions→ Use Discussions -
Help with Usage→ Use Discussions
Submission Guide¶
-
Search First 🔍:
- Check existing issues (open/closed)
- If there are relevant issues, comment if you have more details. If the issue is addressed, give a 👍 reaction to show support, it motivates everyone involved!
- Otherwise, create a new issue following the steps below.
-
File an Issue 🗳
- Navigate to the
Issues
tab and clickNew issue
. - Select the template matching your scenario (bug report, feature request, etc.).
- Fill out all fields (asterisks
*
denote required information). - Click
Create
to submit.
- Navigate to the
Suggestions¶
-
Ensure a Clear Title ✍️
- ✅ Good example:
"Export data error: target file not found"
- ❌ Avoid vague titles:
"Something's wrong!"
- ✅ Good example:
-
Link Related Content 🔗
- If this issue relates to other issues, discussions, or PRs, use
#corresponding-number
to reference them.
- If this issue relates to other issues, discussions, or PRs, use
-
Tell the Full Story
- If create an issue from a template: Fill out all requested fields for complete information.
- If participate in existing issues: Use the simplified template below to share your additional details.
Issue comment template for supplementing details
## If my situation differs from the issue author's
- [ ] No
- [ ] Yes
<!-- If choose yes, describe your case -->
In my case, I found that...
## Steps to Reproduce
<details>
<summary>Steps</summary>
1.
2.
3.
</details>
## Environment
- `OS`: Ubuntu 22.04
- `Python`: 3.10
- `torchmeter`: 0.4.2
## Additional context
<!--
Any addition information helping to resolve this issue is welcome. \
You can include code snippets, error traces, screenshots/GIFs, or other relevant materials here.
-->
<details>
<summary>Details</summary>
1.
2.
3.
</details>