Skip to content

docs: add distro pre-filter documentation - #4591

Merged
LiliDeng merged 1 commit into
mainfrom
johgeorg/docs_distro-pre-filter
Jul 10, 2026
Merged

docs: add distro pre-filter documentation#4591
LiliDeng merged 1 commit into
mainfrom
johgeorg/docs_distro-pre-filter

Conversation

@johnsongeorge-w

Copy link
Copy Markdown
Collaborator

Document the OS-based test case pre-filtering feature

@johnsongeorge-w
johnsongeorge-w requested a review from LiliDeng as a code owner July 9, 2026 20:18
Copilot AI review requested due to automatic review settings July 9, 2026 20:18
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown

✅ AI Test Selection — PASSED

4 test case(s) selected (view run)

Marketplace image: suse sles-15-sp6-arm64 gen2 latest

Count
✅ Passed 0
❌ Failed 0
⏭️ Skipped 0
Total 0
Test case details
Test Case Status Time (s) Message

Copilot AI 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.

Pull request overview

This PR adds documentation for the distro-based test case pre-filtering feature and expands test selection behavior to incorporate a test maturity model (including a default “stable gate”), plus related schema/constants and selftests.

Changes:

  • Add new end-user docs page for distro pre-filtering and link it from the docs index.
  • Introduce maturity levels and a maturity runbook criterion; apply an implicit “stable gate” during selection (including marking OpenVMM suites as preview).
  • Extend selftests to validate maturity filtering and stable-gate behavior.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
selftests/test_testsuite.py Extends the selftest helper to accept pre-built case metadata for selector tests.
selftests/test_testselector.py Adds selftests covering maturity criterion behavior and the implicit stable gate.
lisa/util/constants.py Adds constants for maturity criterion and supported maturity levels.
lisa/testsuite.py Adds maturity metadata at suite and case levels, with inheritance from suite → case.
lisa/testselector.py Implements maturity matching and an implicit stable gate; adds logging around stable-gate decisions.
lisa/schema.py Adds the maturity criterion to the runbook schema and validates allowed values.
lisa/microsoft/testsuites/openvmm/openvmm.py Marks the OpenVMM suite as preview maturity.
lisa/microsoft/testsuites/openvmm/openvmm_tests.py Marks the OpenVMM upstream vmm_tests suite as preview maturity.
docs/index.rst Links the new distro pre-filter documentation page.
docs/distro_pre_filter.rst Adds comprehensive documentation for OS-based pre-filtering and selection flow.

Comment thread docs/index.rst
Comment thread lisa/testselector.py Outdated
Comment thread lisa/testsuite.py Outdated
Comment thread lisa/testsuite.py Outdated
Comment thread lisa/schema.py Outdated
Comment thread lisa/testselector.py Outdated
Document the OS-based test case pre-filtering feature
Copilot AI review requested due to automatic review settings July 9, 2026 20:40
@johnsongeorge-w
johnsongeorge-w force-pushed the johgeorg/docs_distro-pre-filter branch from 86a04b6 to 887bca6 Compare July 9, 2026 20:40

Copilot AI 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.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Copilot AI 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.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

Comment thread docs/distro_pre_filter.rst
Comment thread docs/distro_pre_filter.rst
Comment thread docs/distro_pre_filter.rst
Comment thread docs/distro_pre_filter.rst
@LiliDeng
LiliDeng merged commit 5afacab into main Jul 10, 2026
58 of 59 checks passed
@LiliDeng
LiliDeng deleted the johgeorg/docs_distro-pre-filter branch July 10, 2026 01:51
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.

3 participants