Skip to content

docs: improve bug report template - #109

Merged
AlexStocks merged 3 commits into
AlexStocks:masterfrom
lizining1231:docs/improve-bug-report-template
Aug 16, 2026
Merged

docs: improve bug report template#109
AlexStocks merged 3 commits into
AlexStocks:masterfrom
lizining1231:docs/improve-bug-report-template

Conversation

@lizining1231

@lizining1231 lizining1231 commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

What this PR does:

  • Add an Environment section with required fields (Go version, OS, project version, dependencies)
  • Add a Reproduction prerequisites field
  • Add inline comments to guide reporters on filling each field

Which issue(s) this PR fixes:

Fixes Part of #93

Special notes for your reviewer: N/A

Does this PR introduce a user-facing change?: N/A

Summary by CodeRabbit

  • Documentation
    • Improved the bug report template with required environment details, including Go version, operating system, project version, and dependency versions.
    • Added prompts for issue details, reproduction prerequisites, and additional context.

Add structured sections for version info, reproduction steps,
and expected vs actual behavior to help maintainers reproduce issues faster.
@coderabbitai

coderabbitai Bot commented Aug 7, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: fd7462de-a23a-4b04-bb05-0f3b6ac932ea

📥 Commits

Reviewing files that changed from the base of the PR and between 8dc563b and 71a5ddc.

📒 Files selected for processing (1)
  • .github/ISSUE_TEMPLATE/bug-report.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • .github/ISSUE_TEMPLATE/bug-report.md

Included review availability: Your plan includes up to 4 reviews per rolling hour; 3 remain after this review.


📝 Walkthrough

Walkthrough

The bug report template now collects Go version, operating system, project version, dependency versions, reproduction prerequisites, and additional context. It also separates issue details from environment information.

Changes

Bug report template

Layer / File(s) Summary
Structured bug report fields
.github/ISSUE_TEMPLATE/bug-report.md
The template adds environment fields, introduces an “Issue Details” section, and expands prompts for reproduction prerequisites and additional context.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Merge Risk: ⚪ Minimal · up to 71a5d

This localized documentation change improves bug-report guidance without introducing actionable merge-blocking risk; it is merge-ready after normal checks and review.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change to the bug report template.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/ISSUE_TEMPLATE/bug-report.md:
- Around line 14-22: Update the environment section in the bug-report template
so it does not claim the fields are required unless enforcement is implemented.
Either convert the template to a YAML issue form with validations.required
enabled for each environment field, or change the introductory “Required:”
wording to “Please provide” while preserving the existing fields.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 0b60d480-b03a-41be-ad52-170503847449

📥 Commits

Reviewing files that changed from the base of the PR and between cc9909d and 9a909ea.

📒 Files selected for processing (1)
  • .github/ISSUE_TEMPLATE/bug-report.md

Comment thread .github/ISSUE_TEMPLATE/bug-report.md Outdated
Replace require with Please provide to ensure behavior is consistent with the prompts.
Comment thread .github/ISSUE_TEMPLATE/bug-report.md Outdated
**Operating system**: <!-- e.g. Linux / macOS / Windows -->

**Anything else we need to know?**:
**Project version**: <!-- e.g. v3.3.2 -->

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] 使用 Getty 的实际版本号示例

这个仓库的 tag/version 线是 v1.x(当前最新 tag 为 v1.5.2),v3.3.2 并不存在,容易让报错者把上层项目版本填进 Getty 版本字段。请把字段名明确成 Getty version,并把示例改成仓库实际发布的版本。

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

感谢review,

  • 已切换为getty的版本号示例v1.5.2
  • 已将Project version 具体明确为 Getty version

@AlexStocks
AlexStocks merged commit faf42bd into AlexStocks:master Aug 16, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants