Skip to content

Comments

feature: Add structured GitHub Issue Templates (Fixes #368)#369

Open
aniruddhaadak80 wants to merge 1 commit intoGetStream:mainfrom
aniruddhaadak80:feature/issue-templates
Open

feature: Add structured GitHub Issue Templates (Fixes #368)#369
aniruddhaadak80 wants to merge 1 commit intoGetStream:mainfrom
aniruddhaadak80:feature/issue-templates

Conversation

@aniruddhaadak80
Copy link

@aniruddhaadak80 aniruddhaadak80 commented Feb 21, 2026

Closes #368

Provides formalized YAML templates for bug reports and feature requests. Require users to provide OS, Python version, steps to reproduce, and core motivation. Complements the existing PR template and standardizes triage context.

cc: @aliev @Nash0x7E2 @d3xvn

Summary by CodeRabbit

Chores

  • Added GitHub issue template for bug reports that collects Python version, OS, reproduction steps, expected behavior, and error logs.
  • Added GitHub issue template for feature requests with sections for motivation, proposal, alternatives, and contributor availability indication.

Provides formalized YAML templates for bug reports and feature requests.
Require users to provide OS, Python version, steps to reproduce, and core motivation.
Complements the existing PR template and standardizes triage context.

cc: @aliev @Nash0x7E2 @d3xvn
@coderabbitai
Copy link

coderabbitai bot commented Feb 21, 2026

📝 Walkthrough

Walkthrough

Adds two GitHub issue templates (bug report and feature request) to enforce structured forms for issue submissions. Bug reports collect reproduction steps, environment details, and logs; feature requests capture motivation, proposals, and contribution willingness. Both templates include required fields and default labeling.

Changes

Cohort / File(s) Summary
GitHub Issue Templates
.github/ISSUE_TEMPLATE/bug_report.yml, .github/ISSUE_TEMPLATE/feature_request.yml
Added structured YAML templates for bug reports (68 lines) and feature requests (39 lines) with required/optional fields, default labels, and form metadata to standardize issue submission format.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

Templates descend like bell jars, containing
The chaos of user input—each checkbox
A small violence, a Required stamp
Against the blank terror of undefined bugs.
Order crystallizes. Forms calcify.
The repository breathes, finally structured. ⚙️

🚥 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 specifically describes the main change: adding structured GitHub issue templates for bug reports and feature requests.
Linked Issues check ✅ Passed All requirements from issue #368 are met: bug_report.yml and feature_request.yml templates are added with required fields (OS, Python version, reproduction steps, expected behavior, motivation, proposals, alternatives).
Out of Scope Changes check ✅ Passed All changes are within scope; only the two required YAML template files are added as specified in issue #368.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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 and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (2)
.github/ISSUE_TEMPLATE/feature_request.yml (2)

33-39: required: false is the default and can be omitted.

GitHub's form schema allows setting required per individual checkbox option, but false is the default, making this declaration redundant noise. Drop the key to keep the template clean.

♻️ Suggested cleanup
       options:
         - label: I can contribute this feature myself!
-          required: false
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/ISSUE_TEMPLATE/feature_request.yml around lines 33 - 39, Remove the
redundant "required: false" property from the checkboxes option under the
"contributions" field (type: checkboxes, id: contributions, option label: "I can
contribute this feature myself!") since false is the default; simply delete that
key from the option to keep the template clean.

1-39: Consider adding a Code of Conduct checkbox for consistency with bug_report.yml.

The bug report template requires CoC acknowledgement (terms checkbox, required: true), but the feature request template has no such field. If CoC agreement is a project-wide policy, both templates should enforce it uniformly.

✨ Suggested addition
       options:
         - label: I can contribute this feature myself!
-          required: false
+
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      options:
+        - label: I agree to follow this project's [Code of Conduct](https://github.com/GetStream/Vision-Agents/blob/main/CODE_OF_CONDUCT.md)
+          required: true
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/ISSUE_TEMPLATE/feature_request.yml around lines 1 - 39, Add a
required Code of Conduct checkbox to the feature request template by inserting a
checkboxes entry in the body that mirrors the bug report behavior: add an entry
with id: terms, attributes.label set to a CoC acknowledgement (e.g., "I agree to
the Code of Conduct"), options containing that single checkbox, and
validations/required: true so the field blocks submission until checked; place
this new checkboxes block alongside the existing body fields (motivation,
proposal, alternatives, contributions) to ensure consistent enforcement.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.github/ISSUE_TEMPLATE/bug_report.yml:
- Around line 39-53: Add a new required input field for the vision-agents
package version next to the existing Python version field: create an input block
with id "vision-agents-version", label "vision-agents version", a short
description like "Which vision-agents package version are you using? (e.g.,
1.2.3)", and set validations.required: true so the bug report captures the
library version along with the existing "python-version" and "os" inputs.

---

Nitpick comments:
In @.github/ISSUE_TEMPLATE/feature_request.yml:
- Around line 33-39: Remove the redundant "required: false" property from the
checkboxes option under the "contributions" field (type: checkboxes, id:
contributions, option label: "I can contribute this feature myself!") since
false is the default; simply delete that key from the option to keep the
template clean.
- Around line 1-39: Add a required Code of Conduct checkbox to the feature
request template by inserting a checkboxes entry in the body that mirrors the
bug report behavior: add an entry with id: terms, attributes.label set to a CoC
acknowledgement (e.g., "I agree to the Code of Conduct"), options containing
that single checkbox, and validations/required: true so the field blocks
submission until checked; place this new checkboxes block alongside the existing
body fields (motivation, proposal, alternatives, contributions) to ensure
consistent enforcement.

Comment on lines +39 to +53
- type: input
id: python-version
attributes:
label: Python version
description: Which Python version are you using? (e.g., 3.11.4)
validations:
required: true

- type: input
id: os
attributes:
label: Operating System
description: What operating system are you using? (e.g., macOS Sonoma, Ubuntu 22.04, Windows 11)
validations:
required: true
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Add a vision-agents package version field alongside the Python version.

The template asks for Python version and OS but omits the vision-agents library version itself, which is the most critical piece of context for reproducing version-specific bugs.

✨ Suggested addition
   - type: input
     id: python-version
     attributes:
       label: Python version
       description: Which Python version are you using? (e.g., 3.11.4)
     validations:
       required: true

+  - type: input
+    id: package-version
+    attributes:
+      label: vision-agents version
+      description: Which version of vision-agents are you using? (e.g., 0.1.2)
+    validations:
+      required: true
+
   - type: input
     id: os
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/ISSUE_TEMPLATE/bug_report.yml around lines 39 - 53, Add a new
required input field for the vision-agents package version next to the existing
Python version field: create an input block with id "vision-agents-version",
label "vision-agents version", a short description like "Which vision-agents
package version are you using? (e.g., 1.2.3)", and set validations.required:
true so the bug report captures the library version along with the existing
"python-version" and "os" inputs.

@Nash0x7E2
Copy link
Member

Thank you for your PR @aniruddhaadak80, we will review internally.

cc: @dangusev

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feature: Add structured GitHub Issue Templates

2 participants