Skip to content

chore(ci): generalize PR template Test Plan to Verification#889

Merged
joshuajbouw merged 1 commit into
mainfrom
chore/generic-pr-template
Jun 10, 2026
Merged

chore(ci): generalize PR template Test Plan to Verification#889
joshuajbouw merged 1 commit into
mainfrom
chore/generic-pr-template

Conversation

@joshuajbouw

Copy link
Copy Markdown
Contributor

Linked Issue

Closes #888

Summary

The PR template filled in check hard-requires a non-empty ## Test Plan section, and the template's scaffolding (cargo-test checkboxes) assumes a code-change PR. Release PRs (version bump + changelog roll, e.g. #854), docs-only, and CI-only PRs either fail the check or fill in checkboxes that aren't true. This generalizes the section to ## Verification while keeping the legacy name accepted.

Changes

  • Template: ## Test Plan → generic ## Verification with per-kind guidance (code / release / docs-CI-chore); Checklist CHANGELOG line now covers the release-roll and not-applicable cases.
  • Check: extraction factored into section_content(); new check_section_any() accepts ## Verification or legacy ## Test Plan, so in-flight PRs keep passing.
  • Latent bug fix: the old sed '1d;$d' deleted the range's last line positionally, which ate a content line whenever the checked section was the final section of a PR body. The closing header is now removed by pattern.

Verification

Ran the check function locally against four PR bodies: ## Verification as the final body section with content (passes — previously bitten by the $d bug), legacy ## Test Plan mid-body (passes), comment-placeholder-only section (fails as intended), section absent (fails as intended). This PR's own body exercises the new check end-to-end, since pull_request workflows run from the merge ref.

Checklist

  • Linked to an issue
  • CHANGELOG.md updated (not applicable — CI/template-only change; the changelog workflow does not trigger on .github/ paths)

The 'PR template filled in' check hard-required a non-empty '## Test Plan' section, and the template's scaffolding (cargo-test checkboxes) assumes a code-change PR. Release PRs (version bump + changelog roll), docs-only, and CI-only PRs either failed the check or filled in checkboxes that were not true.

- Template: '## Test Plan' becomes a generic '## Verification' section with guidance per PR kind (code / release / docs-CI-chore); the Checklist CHANGELOG line covers the release-roll and not-applicable cases.
- Check: section extraction is factored into section_content(), and a new check_section_any() accepts '## Verification' or the legacy '## Test Plan' so in-flight PRs keep passing.
- Fixes a latent extraction bug: the old sed '1d;$d' deleted the LAST line of the range positionally, which ate a content line whenever the checked section was the final section of the PR body; the closing header is now removed by pattern.

Verified locally by running the check function against four bodies: Verification-as-last-section (passes, previously bitten by the $d bug), legacy Test Plan (passes), comment-placeholder-only (fails), section missing (fails).

Closes #888
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request updates the repository's pull request template and associated validation logic to be more flexible. By transitioning from a strict 'Test Plan' requirement to a broader 'Verification' section, the template now provides better guidance for various types of contributions, including releases and documentation, while maintaining robust validation checks.

Highlights

  • Template Generalization: Renamed the 'Test Plan' section to 'Verification' in the PR template to better accommodate non-code changes like releases, documentation, and CI updates.
  • Check Logic Improvements: Updated the PR template validation logic to support both the new 'Verification' header and the legacy 'Test Plan' header, ensuring backward compatibility for in-flight PRs.
  • Bug Fix: Resolved a latent bug in the validation script where the final line of a section was incorrectly removed during content extraction.
Ignored Files
  • Ignored by pattern: .github/workflows/** (1)
    • .github/workflows/pr-checks.yml
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.


The template was rigid and tight, It failed when the code wasn't right. Now Verification is here, To make the process quite clear, And keep all the workflows in light.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request updates the pull request template (.github/pull_request_template.md) by renaming the 'Test Plan' section to 'Verification' with updated validation instructions, and refining the CHANGELOG checklist item. The feedback suggests simplifying the CHANGELOG checklist phrasing to improve readability and align its terminology with the verification categories.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread .github/pull_request_template.md
@joshuajbouw joshuajbouw merged commit 3c7a745 into main Jun 10, 2026
12 checks passed
@joshuajbouw joshuajbouw deleted the chore/generic-pr-template branch June 10, 2026 18:12
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.

PR-template CI check assumes code-change PRs — generalize Test Plan to Verification

1 participant