ITS: Bug reporting form is inappropriate (designed for behavioral bugs)
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 45/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 技术栈
- github
- 领域
- tooling
调研方向
Start by reviewing the repository's GitHub issue form configuration and the specialized bug-report form described in this issue. Compare its fields and beta warning with the requested alternatives; done means the form is disabled in favor of a blank template, or its wording, scope, and warning are corrected.
由索引模型根据 Issue 内容生成。
描述
When reporting an issue on this tracker, the first form basically asks which type of issue is being reported. One option is "Bug report", which brings to a form with more than 10 input fields (mostly checkboxes and text fields), which looks like the following:
There's no existing/similar bug report.
Please search to see if an issue already exists for the bug you encountered.
I have searched the existing issues *
This report is about a single actionable bug.Please create one issue per bug, split up your bug reports if needed.
I'm reporting a single actionable bug *
This report is about the ProGit book, version 2, English language.Bug reports about translations or the first version of the book are not accepted.
This bug is not about a translation or old version *
Bug covers book website/pdfThis bug is about the book as found on the website or the PDF.
I confirm the bug is about the book as found on the website/pdf
Problem is present in the Pro Git book on the website?If you found an issue in the pdf/epub/mobi files, you've checked if the problem is also present in the Pro Git book on the website.
This bug also affects the Pro Git book as published on the website.
Which version of the book is affected?It's important for us to know if the problem is in the source or in the tooling that creates the pdf/epub/mobi files.
Therefore, please select which versions are affected.
Describe the bug:A clear and concise description of what the bug is.
Steps to reproduce:Please write the steps needed to reproduce the bug here.
[...]
Expected behavior:A clear and concise description of what you expected to happen.
Screenshots:If applicable, add screenshots to help explain your problem.
Additional context:Add any other context about the problem here.
You can also put references to similar bugs here.
DeviceTell us what kind of device you're using to access the content.
Operating systemIf the problem is with the book or the published files, we need to know what operating system you run on your device.
Browser/application + versionWhat browser/application are you using? We also need the version number of the browser/application.
The form is discreetly marked as beta at the right:
Indeed, there are numerous issues with that form. Notably:
- It conflates issues with issue reports (for example in "Please create one issue per bug").
- The section title "Which version of the book is affected?" does not match its content.
- It assumes the bug is behavioral, requiring to specify reproductions steps and expected behavior. While this is often the case with software, this assumption is particularly incorrect since… Pro Git is not software.😅
I would recommend to:
- Disable that specialized reporting form until it is mature, directing bug reporters to a blank template instead, even though the intention is of course noble.
- If not, make the beta warning sufficiently prominent (minimally, remove the misleading green color, perhaps replacing with orange/yellow).
- 主要语言
- CSS
- 星标
- 6.6k
- 派生
- 2.1k
- PR 合并指标
- 30 天内没有已合并 PR
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
progit/progit2 的其他 Issue
-
bug
难度 2/5 1-3 小时 新手友好度 78/100
-
bug
难度 2/5 1-3 小时 新手友好度 72/100
-
bug
难度 2/5 1-3 小时 新手友好度 68/100
-
enhancement
难度 1/5 1 小时以内 新手友好度 82/100
-
enhancement
难度 1/5 1-3 小时 新手友好度 65/100
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 70/100
pastelsky/bundlephobia#1122 ·
-
难度 2/5 1-3 小时 新手友好度 75/100
anthropics/skills#1811 · 1 条评论 ·
-
bug
难度 2/5 1-3 小时 新手友好度 75/100
CachyOS/distribution#587 ·
-
bug
难度 2/5 1-3 小时 新手友好度 75/100
datalayer/mcp-compose#42 ·
-
难度 2/5 1-3 小时 新手友好度 70/100