Skip to content

CONSOLE-5204: Add PR template#1141

Merged
openshift-merge-bot[bot] merged 1 commit intoopenshift:mainfrom
logonoff:CONSOLE-5204-template
Apr 24, 2026
Merged

CONSOLE-5204: Add PR template#1141
openshift-merge-bot[bot] merged 1 commit intoopenshift:mainfrom
logonoff:CONSOLE-5204-template

Conversation

@logonoff
Copy link
Copy Markdown
Member

@logonoff logonoff commented Apr 23, 2026

Copied from console openshift/console#16287

Summary by CodeRabbit

  • Documentation

    • Added a standardized pull request template that enforces Jira-prefixed titles, requires filled sections for analysis/root cause and solution, captures explicit test setup and test cases, includes browser conformance checkboxes (Chrome/Firefox/Safari), and provides reviewer/assignee guidance and assignment placeholders.
  • Note

    • This is an internal process improvement with no direct impact on end-user functionality.

@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Apr 23, 2026
@openshift-ci-robot
Copy link
Copy Markdown
Contributor

openshift-ci-robot commented Apr 23, 2026

@logonoff: This pull request references CONSOLE-5204 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the sub-task to target the "5.0.0" version, but no target version was set.

Details

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

@logonoff
Copy link
Copy Markdown
Member Author

/label px-approved
/label docs-approved
/verified bypass

@openshift-ci openshift-ci Bot added the px-approved Signifies that Product Support has signed off on this PR label Apr 23, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 23, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited)

Review profile: CHILL

Plan: Enterprise

Run ID: 85faa627-f4e7-4a8f-929e-37362d5648bd

📥 Commits

Reviewing files that changed from the base of the PR and between 75ae4c8 and 0505526.

📒 Files selected for processing (1)
  • docs/pull_request_template.md
✅ Files skipped from review due to trivial changes (1)
  • docs/pull_request_template.md
📜 Recent review details
🧰 Additional context used
🔀 Multi-repo context openshift/console

openshift/console

  • New PR template added: docs/pull_request_template.md — file content includes required PR sections (Analysis/Root cause, Solution description, Screenshots, Test setup/cases, Browser conformance, Additional info, Reviewers/assignees). [::openshift/console::docs/pull_request_template.md]

  • Internal doc references updated/pointing to the new template:

    • AGENTS.md line ~93 references docs/pull_request_template.md as the PR template contributors should fill out. [::openshift/console::AGENTS.md:93]

Notes:

  • No code/API/type/export changes in this PR.
  • No other repositories available to search for cross-repo impact.

Walkthrough

Adds a new pull request template at docs/pull_request_template.md containing a mandatory OpenShift Console PR checklist with sections for title requirements, analysis/root cause, solution details, test setup and cases, browser conformance, and reviewer/assignee guidance.

Changes

Cohort / File(s) Summary
Pull Request Template
docs/pull_request_template.md
New template file with mandatory PR sections including analysis/root cause, solution description, screenshots, test setup, explicit test cases, browser conformance checklist (Chrome/Firefox/Safari), reviewer/assignee instructions, and assignment command placeholders.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 12
✅ Passed checks (12 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly references the Jira issue (CONSOLE-5204) and clearly describes the main change: adding a pull request template to the repository.
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.
Stable And Deterministic Test Names ✅ Passed This custom check for stable and deterministic Ginkgo test names is not applicable to this pull request. The PR exclusively adds documentation files with no test code.
Test Structure And Quality ✅ Passed PR adds only documentation file with no Ginkgo test code, making custom check not applicable.
Microshift Test Compatibility ✅ Passed PR only adds documentation file; no new Ginkgo e2e tests are introduced, so MicroShift test compatibility check does not apply.
Single Node Openshift (Sno) Test Compatibility ✅ Passed PR only modifies docs/pull_request_template.md, a documentation file with no Ginkgo e2e tests or test code.
Topology-Aware Scheduling Compatibility ✅ Passed PR adds only documentation file with no code, deployment manifests, operator code, controllers, or scheduling constraints.
Ote Binary Stdout Contract ✅ Passed This PR modifies only a markdown documentation file with no executable code, test logic, or binary components.
Ipv6 And Disconnected Network Test Compatibility ✅ Passed PR only adds documentation file, no Ginkgo e2e tests or Go test code present.

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

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Comment @coderabbitai help to get the list of available commands and usage tips.

@openshift-ci openshift-ci Bot added the docs-approved Signifies that Docs has signed off on this PR label Apr 23, 2026
@openshift-ci-robot openshift-ci-robot added the verified Signifies that the PR passed pre-merge verification criteria label Apr 23, 2026
@openshift-ci-robot
Copy link
Copy Markdown
Contributor

@logonoff: The verified label has been added.

Details

In response to this:

/label px-approved
/label docs-approved
/verified bypass

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

@openshift-ci openshift-ci Bot requested review from TheRealJon and jhadvig April 23, 2026 18:32
@openshift-ci-robot
Copy link
Copy Markdown
Contributor

openshift-ci-robot commented Apr 23, 2026

@logonoff: This pull request references CONSOLE-5204 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the sub-task to target the "5.0.0" version, but no target version was set.

Details

In response to this:

Copied from console openshift/console#16287

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

Copy link
Copy Markdown

@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: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/pull_request_template.md`:
- Around line 8-11: Summary: Replace the incorrect phrase "For e.g" with a
correct form. Locate the two occurrences of the literal strings "For e.g
Features: https://redhat.atlassian.net/browse/CONSOLE-XXXX" and "For e.g Jira
Bug Fixes: https://redhat.atlassian.net/browse/OCPBUGS-XXXX" and change "For
e.g" to "For example," (or alternatively "E.g.,") so the lines read "For example
Features: ..." (better: "For example, Features: ...") and "For example, Jira Bug
Fixes: ..." ensuring punctuation and spacing are correct.
- Line 41: Remove or adapt the frontend-specific UX review instruction that
reads "If there are visual, content, or interaction changes in the PR, tag
\"@openshift/team-ux-review\"" and similarly remove or revise other
frontend-specific sections ("Browser conformance testing", "Screenshots/screen
recordings", and "PX approver") in docs/pull_request_template.md so the template
reflects a backend/operator workflow; replace them with operator-appropriate
guidance (e.g., testing for cluster compatibility, upgrade/migration notes, and
owner/approver expectations) and ensure the UX/team-ux-review reference is
deleted or replaced with an appropriate operator reviewer group.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited)

Review profile: CHILL

Plan: Enterprise

Run ID: 5a63ef0d-9ad0-4dd7-972b-4e832df5d41f

📥 Commits

Reviewing files that changed from the base of the PR and between f061939 and 75ae4c8.

📒 Files selected for processing (1)
  • docs/pull_request_template.md
📜 Review details
🧰 Additional context used
🔀 Multi-repo context openshift/console

openshift/console

  • New PR template added: docs/pull_request_template.md — file content includes required PR sections (Analysis/Root cause, Solution description, Screenshots, Test setup/cases, Browser conformance, Additional info, Reviewers/assignees). [::openshift/console::docs/pull_request_template.md]

  • Internal doc references updated/pointing to the new template:

    • AGENTS.md line ~93 references docs/pull_request_template.md as the PR template contributors should fill out. [::openshift/console::AGENTS.md:93]

Notes:

  • No code/API/type/export changes in this PR.
  • No other repositories available to search for cross-repo impact.
🔇 Additional comments (1)
docs/pull_request_template.md (1)

29-33: Verify relevance of browser conformance section for an operator repository.

The browser conformance checklist is typically relevant for frontend web applications. Since console-operator is a Kubernetes operator (backend infrastructure component), browser-specific testing may not be applicable to most PRs in this repository.

Consider whether this section should be:

  • Removed entirely
  • Made optional/conditional
  • Clarified to indicate it only applies to specific types of changes

If browser testing is indeed necessary for console-operator changes, please clarify in the template when this section applies.

Comment on lines +8 to +11
For e.g Features: https://redhat.atlassian.net/browse/CONSOLE-XXXX
- CONSOLE-XXXX: <title>
For e.g Jira Bug Fixes: https://redhat.atlassian.net/browse/OCPBUGS-XXXX
- OCPBUGS-XXXX: <title>
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix grammatical error: "For e.g" is incorrect.

The phrase "For e.g" is grammatically incorrect as it redundantly combines "for example" with the abbreviation "e.g." (which already means "for example"). Use either "For example," or "E.g.," but not both.

📝 Proposed fix
- For e.g Features: https://redhat.atlassian.net/browse/CONSOLE-XXXX
+ For example, Features: https://redhat.atlassian.net/browse/CONSOLE-XXXX
  - CONSOLE-XXXX: <title>
- For e.g Jira Bug Fixes: https://redhat.atlassian.net/browse/OCPBUGS-XXXX
+ For example, Bug Fixes: https://redhat.atlassian.net/browse/OCPBUGS-XXXX
  - OCPBUGS-XXXX: <title>
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/pull_request_template.md` around lines 8 - 11, Summary: Replace the
incorrect phrase "For e.g" with a correct form. Locate the two occurrences of
the literal strings "For e.g Features:
https://redhat.atlassian.net/browse/CONSOLE-XXXX" and "For e.g Jira Bug Fixes:
https://redhat.atlassian.net/browse/OCPBUGS-XXXX" and change "For e.g" to "For
example," (or alternatively "E.g.,") so the lines read "For example Features:
..." (better: "For example, Features: ...") and "For example, Jira Bug Fixes:
..." ensuring punctuation and spacing are correct.

**Reviewers and assignees:**
<!--
- Tag an OCP console engineer to review the changes and verify the functionality.
- If there are visual, content, or interaction changes in the PR, tag "@openshift/team-ux-review"
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check if this team handle is referenced elsewhere in the repository
rg -i "team-ux-review" --type md

Repository: openshift/console-operator

Length of output: 197


🏁 Script executed:

#!/bin/bash
# Check if openshift/console has a similar PR template with team-ux-review
if [ -f "docs/pull_request_template.md" ]; then
  echo "=== openshift/console PR template exists ==="
  cat -n "docs/pull_request_template.md" | head -50
fi

Repository: openshift/console

Length of output: 2096


🏁 Script executed:

#!/bin/bash
# Check what teams or processes are mentioned in console-operator docs/guidelines
find . -type f \( -name "*.md" -o -name "*.txt" \) | head -20 | xargs grep -l -i "review\|team\|contributor" 2>/dev/null | head -10

Repository: openshift/console-operator

Length of output: 466


🏁 Script executed:

#!/bin/bash
# Check console-operator's contribution guidelines and review process
for file in CONTRIBUTING.md DEVELOPMENT.md README.md; do
  if [ -f "$file" ]; then
    echo "=== $file ==="
    head -100 "$file"
  fi
done

Repository: openshift/console-operator

Length of output: 2927


🏁 Script executed:

#!/bin/bash
# Check the full console-operator PR template to see what it actually says
cat -n docs/pull_request_template.md

Repository: openshift/console-operator

Length of output: 2071


Remove or adapt the UX review instruction for console-operator.

The PR template in console-operator was copied directly from openshift/console without accounting for the different nature of each repository. Console-operator is a backend Kubernetes operator managing console deployment—it doesn't produce visual, content, or interaction changes. The instruction to tag @openshift/team-ux-review is not applicable here.

Additionally, other sections of this template are also misaligned for an operator repository, including:

  • Browser conformance testing (lines 29–33) — irrelevant for backend code
  • Screenshots/screen recordings (line 20) — unlikely to be needed
  • PX approver assignment (line 50) — not applicable to operator PRs

Either adapt the entire template for console-operator's actual contribution process or remove sections specific to frontend development.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/pull_request_template.md` at line 41, Remove or adapt the
frontend-specific UX review instruction that reads "If there are visual,
content, or interaction changes in the PR, tag \"@openshift/team-ux-review\""
and similarly remove or revise other frontend-specific sections ("Browser
conformance testing", "Screenshots/screen recordings", and "PX approver") in
docs/pull_request_template.md so the template reflects a backend/operator
workflow; replace them with operator-appropriate guidance (e.g., testing for
cluster compatibility, upgrade/migration notes, and owner/approver expectations)
and ensure the UX/team-ux-review reference is deleted or replaced with an
appropriate operator reviewer group.

@logonoff logonoff force-pushed the CONSOLE-5204-template branch from 75ae4c8 to 0505526 Compare April 23, 2026 18:41
@openshift-ci-robot openshift-ci-robot removed the verified Signifies that the PR passed pre-merge verification criteria label Apr 23, 2026
@logonoff
Copy link
Copy Markdown
Member Author

/verified bypass

@openshift-ci-robot openshift-ci-robot added the verified Signifies that the PR passed pre-merge verification criteria label Apr 23, 2026
@openshift-ci-robot
Copy link
Copy Markdown
Contributor

@logonoff: The verified label has been added.

Details

In response to this:

/verified bypass

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

Copy link
Copy Markdown
Member

@jhadvig jhadvig left a comment

Choose a reason for hiding this comment

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

/lgtm
/approve

@openshift-ci openshift-ci Bot added the lgtm Indicates that a PR is ready to be merged. label Apr 23, 2026
@openshift-ci
Copy link
Copy Markdown
Contributor

openshift-ci Bot commented Apr 23, 2026

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: jhadvig, logonoff

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-ci openshift-ci Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Apr 23, 2026
@openshift-merge-bot
Copy link
Copy Markdown
Contributor

/retest-required

Remaining retests: 0 against base HEAD f061939 and 2 for PR HEAD 0505526 in total

@logonoff
Copy link
Copy Markdown
Member Author

/retest

@openshift-ci
Copy link
Copy Markdown
Contributor

openshift-ci Bot commented Apr 24, 2026

@logonoff: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@openshift-merge-bot openshift-merge-bot Bot merged commit 5ced247 into openshift:main Apr 24, 2026
11 checks passed
@logonoff logonoff deleted the CONSOLE-5204-template branch April 24, 2026 02:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. docs-approved Signifies that Docs has signed off on this PR jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. lgtm Indicates that a PR is ready to be merged. px-approved Signifies that Product Support has signed off on this PR verified Signifies that the PR passed pre-merge verification criteria

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants