Skip to content

Revise new feature issue template options and validations#2481

Merged
Krishanx92 merged 1 commit into
mainfrom
Krishanx92-patch-1
Jul 6, 2026
Merged

Revise new feature issue template options and validations#2481
Krishanx92 merged 1 commit into
mainfrom
Krishanx92-patch-1

Conversation

@Krishanx92

Copy link
Copy Markdown
Contributor

Updated the new feature issue template to simplify area options and added steps to verify.

Purpose

Explain why this feature or fix is required. Describe the underlying problems, issues, or needs driving this feature/fix and include links to related issues in the following format: Resolves issue1, issue2, etc.

Goals

Describe what solutions this feature or fix introduces to address the problems outlined above.

Approach

Describe how you are implementing the solutions. Include an animated GIF or screenshot if the change affects the UI. Include a link to a Markdown file or Google doc if the feature write-up is too long to paste here.

User stories

Summary of user stories addressed by this change>

Documentation

Link(s) to product documentation that addresses the changes of this PR. If no doc impact, enter “N/A” plus brief explanation of why there’s no doc impact

Automation tests

  • Unit tests

    Code coverage information

  • Integration tests

    Details about the test cases and coverage

Security checks

Samples

Provide high-level details about the samples related to this feature

Related PRs

List any other related PRs

Test environment

List all JDK versions, operating systems, databases, and browser/versions on which this feature/fix was tested

Updated the new feature issue template to simplify area options and added steps to verify.
@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

Updated the issue template's "area" dropdown to replace previous "Area/*" categories with new options (Gateway, Platform API, Developer Portal, AI Workspace, CLI, Gateway Operator, Event Gateway), and added a "Steps to Verify" checklist section.

Changes

Issue Template Update

Layer / File(s) Summary
Area dropdown and verification checklist
.github/ISSUE_TEMPLATE/new-feature.yml
Replaced the area dropdown options with a new category list and added a "Steps to Verify" checklist covering design documentation, code review, testing, documentation, and feature completeness.

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

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description mostly repeats the template headings and lacks concrete content for the required sections. Replace the placeholders with actual details for Purpose, Goals, Approach, Documentation, tests, security, samples, related PRs, and test environment.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the template option and validation updates.
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
  • Commit unit tests in branch Krishanx92-patch-1

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.

@Krishanx92
Krishanx92 merged commit 2c35a9c into main Jul 6, 2026
4 of 5 checks passed

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (2)
.github/ISSUE_TEMPLATE/new-feature.yml (2)

54-65: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Steps to Verify checklist mixes implementation-completion tracking into the intake form.

Items like "Code Review", "Testing", and "Feature Complete" describe work done during/after implementation, not something a reporter fills in when filing a new feature request. Since there's no validations block, this is optional, but consider whether this checklist belongs in the issue body vs. being tracked separately (e.g., PR template or project board) to avoid confusing reporters who open the form expecting only a request-intake flow.

🤖 Prompt for 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.

In @.github/ISSUE_TEMPLATE/new-feature.yml around lines 54 - 65, The new feature
intake template’s Steps to Verify checklist is mixing request intake with
implementation/completion tracking. Update the checklist under the issue body
template so it only captures reporter-facing verification or acceptance details,
and move items like “Code Review,” “Testing,” and “Feature Complete” to a
PR/process-specific template or separate tracking flow. Use the existing
new-feature.yml checklist block as the place to adjust what a feature requester
should fill out.

13-19: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Area options diverge from the sibling template's naming/labeling convention and drop the fallback option.

The improvement.yml template still uses the Area/* prefixed convention with per-option descriptions and an Area/Other catch-all. This new list uses bare names with no descriptions and no fallback for issues that don't fit any of the 7 fixed categories, which could force reporters to mis-categorize their issue or force maintainers to relabel manually.

💡 Consider aligning naming and adding a fallback
       options:
-        - Gateway
-        - Platform API
-        - Developer Portal
-        - AI Workspace
-        - CLI
-        - Gateway Operator
-        - Event Gateway
+        - Gateway
+        - Platform API
+        - Developer Portal
+        - AI Workspace
+        - CLI
+        - Gateway Operator
+        - Event Gateway
+        - Other (Anything else which does not match above categories)

If this dropdown feeds into a label-automation workflow that expects the Area/* prefix, verify that workflow is updated accordingly.

🤖 Prompt for 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.

In @.github/ISSUE_TEMPLATE/new-feature.yml around lines 13 - 19, The Area
dropdown in the new-feature template is inconsistent with the sibling template’s
Area/* convention and is missing a fallback option. Update the options in the
new-feature template to match the existing labeling pattern used by the other
issue template, including per-option descriptions and an Area/Other catch-all.
If any label automation depends on these values, make sure it is updated to
accept the revised option names.
🤖 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.

Nitpick comments:
In @.github/ISSUE_TEMPLATE/new-feature.yml:
- Around line 54-65: The new feature intake template’s Steps to Verify checklist
is mixing request intake with implementation/completion tracking. Update the
checklist under the issue body template so it only captures reporter-facing
verification or acceptance details, and move items like “Code Review,”
“Testing,” and “Feature Complete” to a PR/process-specific template or separate
tracking flow. Use the existing new-feature.yml checklist block as the place to
adjust what a feature requester should fill out.
- Around line 13-19: The Area dropdown in the new-feature template is
inconsistent with the sibling template’s Area/* convention and is missing a
fallback option. Update the options in the new-feature template to match the
existing labeling pattern used by the other issue template, including per-option
descriptions and an Area/Other catch-all. If any label automation depends on
these values, make sure it is updated to accept the revised option names.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: f3e699d9-db3f-4680-97d4-10cfe44f6553

📥 Commits

Reviewing files that changed from the base of the PR and between 92078a9 and 1e892f4.

📒 Files selected for processing (1)
  • .github/ISSUE_TEMPLATE/new-feature.yml

@coderabbitai coderabbitai Bot mentioned this pull request Jul 7, 2026
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