Skip to content

feat: add Tier 3 testing classification for extended validation - #123

Merged
rnetser merged 2 commits into
RedHatQE:mainfrom
rnetser:feature/add-tier3-testing-classification
Jul 1, 2026
Merged

feat: add Tier 3 testing classification for extended validation#123
rnetser merged 2 commits into
RedHatQE:mainfrom
rnetser:feature/add-tier3-testing-classification

Conversation

@rnetser

@rnetser rnetser commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Add Tier 3 (Extended Validation) as a new testing tier for tests with higher execution cost — longer runtime, heavier resource usage, or complex setup — that typically run in dedicated test cycles rather than standard CI lanes.

Changes

  • AGENTS.md — Added Tier 3 to tier classification and checklist
  • docs/testing-tiers.md — Full Tier 3 section, updated pyramid and comparison matrix
  • docs/stp-guide.md — Updated sign-off checklist
  • README.md — Updated description, glossary, diagram, and milestone
  • stps/stp-template/stp.md — Added Tier 3 example scenario
  • stps/stp-template/child-stp.md — Updated tier field options

Summary by CodeRabbit

  • Documentation
    • Added Tier 3 (Extended Validation Tests) guidance, including how it fits into the testing progression and what distinguishes it from lower tiers.
    • Updated the testing tiers guide, checklist rules, and sign-off requirements to reflect Tier 3 (where applicable).
    • Enhanced STP templates and the tier selection template to support tiers 1, 2, and 3.
    • Included an expanded example scenario for Windows guest / NTFS under Tier 3.

Add Tier 3 (Extended Validation) as a new testing tier for tests
with higher execution cost — longer runtime, heavier resource
usage, or complex setup — that typically run in dedicated test
cycles rather than standard CI lanes.

Updated files: AGENTS.md, docs/testing-tiers.md, docs/stp-guide.md,
README.md, stps/stp-template/stp.md, stps/stp-template/child-stp.md

Signed-off-by: rnetser <rnetser@redhat.com>
Co-authored-by: Claude <noreply@anthropic.com>
@openshift-virtualization-qe-bot-2

Copy link
Copy Markdown

Report bugs in Issues

Welcome! 🎉

This pull request will be automatically processed with the following features:

🔄 Automatic Actions

  • Reviewer Assignment: Reviewers are automatically assigned based on the OWNERS file in the repository root
  • Size Labeling: PR size labels (XS, S, M, L, XL, XXL) are automatically applied based on changes
  • Issue Creation: A tracking issue is created for this PR and will be closed when the PR is merged or closed
  • Branch Labeling: Branch-specific labels are applied to track the target branch
  • Auto-verification: Auto-verified users have their PRs automatically marked as verified
  • Labels: Enabled categories: branch, can-be-merged, cherry-pick, has-conflicts, hold, needs-rebase, size, verified, wip

📋 Available Commands

PR Status Management

  • /wip - Mark PR as work in progress (adds WIP: prefix to title)
  • /wip cancel - Remove work in progress status
  • /hold - Block PR merging (approvers only)
  • /hold cancel - Unblock PR merging
  • /verified - Mark PR as verified
  • /verified cancel - Remove verification status
  • /reprocess - Trigger complete PR workflow reprocessing (useful if webhook failed or configuration changed)
  • /regenerate-welcome - Regenerate this welcome message
  • /security-override - Set security check runs to pass (maintainers only)
  • /security-override cancel - Re-run security checks

Review & Approval

  • /lgtm - Approve changes (looks good to me)
  • /approve - Approve PR (approvers only)
  • /assign-reviewers - Assign reviewers based on OWNERS file
  • /assign-reviewer @username - Assign specific reviewer
  • /check-can-merge - Check if PR meets merge requirements

Testing & Validation

  • /retest tox - Run Python test suite with tox
  • /retest all - Run all available tests

Cherry-pick Operations

  • /cherry-pick <branch> - Schedule cherry-pick to target branch when PR is merged
    • Multiple branches: /cherry-pick branch1 branch2 branch3
  • /cherry-pick-retry <branch> - Retry a failed cherry-pick (merged PRs only)

Branch Management

  • /rebase - Rebase this PR branch onto its base branch

Label Management

  • /<label-name> - Add a label to the PR
  • /<label-name> cancel - Remove a label from the PR

✅ Merge Requirements

This PR will be automatically approved when the following conditions are met:

  1. Approval: /approve from at least one approver
  2. LGTM Count: Minimum 2 /lgtm from reviewers
  3. Status Checks: All required status checks must pass
  4. No Blockers: No wip, hold, has-conflicts labels and PR must be mergeable (no conflicts)

📊 Review Process

Approvers and Reviewers

Approvers:

  • rnetser

Reviewers:

  • rnetser
Available Labels
  • hold
  • verified
  • wip
  • lgtm
  • approve
AI Features
  • Cherry-Pick Conflict Resolution: Enabled (claude/claude-opus-4-6-1m)
Security Checks
  • Suspicious Path Detection: Monitors paths: .claude/, .vscode/, .cursor/, .devcontainer/, .pi/, .github/workflows/, .github/actions/
  • Committer Identity Check: Verifies last committer matches PR author
  • Mandatory: Security checks block merge (use /security-override to bypass — maintainers only)

💡 Tips

  • WIP Status: Use /wip when your PR is not ready for review
  • Verification: The verified label is removed on new commits unless the push is detected as a clean rebase
  • Cherry-picking: Cherry-pick labels are processed when the PR is merged
  • Permission Levels: Some commands require approver permissions
  • Auto-verified Users: Certain users have automatic verification and merge privileges

For more information, please refer to the project documentation or contact the maintainers.

@coderabbitai

coderabbitai Bot commented Jul 1, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 8929e502-6fae-49b7-a79a-868ec48697e8

📥 Commits

Reviewing files that changed from the base of the PR and between 2ab276a and 10f0c97.

📒 Files selected for processing (2)
  • README.md
  • docs/stp-guide.md

📝 Walkthrough

Walkthrough

Documentation and STP templates now treat Tier 3 as a valid test classification. The tier guide, review checklists, milestone requirements, template tier options, and one example scenario were updated to reflect the new tier.

Changes

Tier 3 Testing Classification Rollout

Layer / File(s) Summary
Tier 3 definition and testing tiers guide
docs/testing-tiers.md, README.md
Tier 3 (Extended Validation) is added to the testing pyramid, tier descriptions, comparison matrix, and README tier progression guidance.
Checklist and milestone updates for Tier 3
AGENTS.md, README.md, docs/stp-guide.md
Tier 3 is allowed or required in checklist, milestone, and sign-off wording alongside Tier 1 and Tier 2.
STP template Tier field and example scenario
stps/stp-template/child-stp.md, stps/stp-template/stp.md
The Tier field accepts 1, 2, or 3, and a Tier 3 Windows guest NTFS example scenario is added.

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

Possibly related PRs

Suggested reviewers: geetikakay, dominikholler

🚥 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 accurately summarizes the main change: introducing Tier 3 extended validation testing classification.
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

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

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 current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/stp-guide.md`:
- Line 166: Update the final sign-off checklist item in the STP guide so it does
not imply Tier 3 is mandatory for every feature; qualify the entry around the
checklist text that mentions Tier 1 / Tier 2 / Tier 3 tests defined by adding
“as applicable” or making Tier 3 conditional, so only relevant validation tiers
are required.

In `@README.md`:
- Line 86: Rephrase the coverage guidance in the README so it no longer implies
every STP must include Tier 3; update the test-coverage wording to clearly
distinguish the required Tier 1 and Tier 2 coverage from the optional Tier 3
extended-validation coverage. Locate the bullet mentioning Tier 1, Tier 2, and
Tier 3 test coverage and make it conditional so feature plans without Tier 3 do
not read as incomplete.
🪄 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: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: fa426615-dcaf-4c06-a6ac-60dff33f598e

📥 Commits

Reviewing files that changed from the base of the PR and between 8d5af15 and 2ab276a.

📒 Files selected for processing (6)
  • AGENTS.md
  • README.md
  • docs/stp-guide.md
  • docs/testing-tiers.md
  • stps/stp-template/child-stp.md
  • stps/stp-template/stp.md

Comment thread docs/stp-guide.md Outdated
Comment thread README.md Outdated
Tier 3 is optional extended validation, not mandatory for every STP.
Updated sign-off checklist and process milestone to say 'where applicable'.

Signed-off-by: rnetser <rnetser@redhat.com>

Co-authored-by: PI (claude-opus-4-6) <noreply@pi.dev>
Signed-off-by: rnetser <rnetser@redhat.com>
@rnetser

rnetser commented Jul 1, 2026

Copy link
Copy Markdown
Contributor Author

/approve
/lgtm

@rnetser
rnetser merged commit 8a940f4 into RedHatQE:main Jul 1, 2026
8 checks passed
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.

6 participants