Skip to content

docs: improve PR template with Related Issue and Type of Change sections#7703

Open
dipanshurdev wants to merge 1 commit intousebruno:mainfrom
dipanshurdev:fix/pr-template
Open

docs: improve PR template with Related Issue and Type of Change sections#7703
dipanshurdev wants to merge 1 commit intousebruno:mainfrom
dipanshurdev:fix/pr-template

Conversation

@dipanshurdev
Copy link
Copy Markdown

@dipanshurdev dipanshurdev commented Apr 7, 2026

Description

This PR updates the Pull Request template to improve the contribution workflow.

These changes help maintainers by:

  • Standardizing Context: Prompts contributors to link a 'Related Issue' upfront.
  • Quick Triage: Adds a 'Type of Change' checklist (Bug fix, Feature, etc.) so you can understand the impact of a PR at a glance.

Related Issue

None (Internal process improvement)

Type of Change

  • Documentation update
  • Refactoring (PR process metadata)

Summary by CodeRabbit

  • Chores
    • Updated the pull request template with new sections for related issue references and change type categorization, including checkbox options for bug fixes, new features, breaking changes, documentation updates, and refactoring work.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 7, 2026

Walkthrough

Updated the GitHub pull request template to include new "Related Issue" and "Type of Change" sections with checkbox options for categorizing contributions, while preserving the existing "Contribution Checklist" section.

Changes

Cohort / File(s) Summary
GitHub Configuration
.github/PULL_REQUEST_TEMPLATE.md
Added "Related Issue" and "Type of Change" sections with checkboxes for bug fix, new feature, breaking change, documentation update, and refactoring categories.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

PRs now have structure, neat and clear,
With categories to persevere,
Bug fix or feature, breaking too—
The template now knows what you do! 📋✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: updating the PR template with two new sections (Related Issue and Type of Change), which directly matches the changeset.
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

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
Copy Markdown
Contributor

@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.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
.github/PULL_REQUEST_TEMPLATE.md (1)

26-26: ⚠️ Potential issue | 🟡 Minor

Make issue-linking conditional to avoid false blocking

This checklist item reads as mandatory, but not every PR has a related issue (including internal process/docs changes). Consider making it conditional.

Suggested tweak
-- [ ] **Create an issue and link to the pull request.**
+- [ ] **If applicable, I have linked the related issue to this pull request.**
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/PULL_REQUEST_TEMPLATE.md at line 26, The checklist item "[ ]
**Create an issue and link to the pull request.**" should be made
conditional/optional; update the PR template so that this line reads something
like "[ ] **If applicable: create an issue and link to the pull request.**" or
move it into an "Optional" section, ensuring the wording includes "if
applicable" to avoid blocking PRs that legitimately have no related issue (refer
to the exact checklist string to locate and change it).
🧹 Nitpick comments (1)
.github/PULL_REQUEST_TEMPLATE.md (1)

11-17: Prefer checkbox selection over deleting options

Asking contributors to delete lines adds friction and noisy diffs. Prefer “check all that apply” for this section.

Suggested tweak
-<!-- Please delete options that are not relevant. -->
+<!-- Check all options that apply. -->
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/PULL_REQUEST_TEMPLATE.md around lines 11 - 17, Replace the “Please
delete options that are not relevant.” instruction and the current dash-list of
options in .github/PULL_REQUEST_TEMPLATE.md with an explicit checkbox checklist
that contributors should check instead of deleting; update the options (the list
items shown in the template) to use unchecked checkboxes (e.g., - [ ] ) and
change the accompanying guidance text to “Check all that apply” (or similar) so
contributors mark applicable boxes rather than removing lines.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In @.github/PULL_REQUEST_TEMPLATE.md:
- Line 26: The checklist item "[ ] **Create an issue and link to the pull
request.**" should be made conditional/optional; update the PR template so that
this line reads something like "[ ] **If applicable: create an issue and link to
the pull request.**" or move it into an "Optional" section, ensuring the wording
includes "if applicable" to avoid blocking PRs that legitimately have no related
issue (refer to the exact checklist string to locate and change it).

---

Nitpick comments:
In @.github/PULL_REQUEST_TEMPLATE.md:
- Around line 11-17: Replace the “Please delete options that are not relevant.”
instruction and the current dash-list of options in
.github/PULL_REQUEST_TEMPLATE.md with an explicit checkbox checklist that
contributors should check instead of deleting; update the options (the list
items shown in the template) to use unchecked checkboxes (e.g., - [ ] ) and
change the accompanying guidance text to “Check all that apply” (or similar) so
contributors mark applicable boxes rather than removing lines.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 32cfe8d9-1461-4e6c-87d5-9924aef5fd75

📥 Commits

Reviewing files that changed from the base of the PR and between d4cd34f and 0e9e89e.

📒 Files selected for processing (1)
  • .github/PULL_REQUEST_TEMPLATE.md

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant