Skip to content

docs(testing): define Nix and tmachine target state - #3460

Draft
elezar wants to merge 3 commits into
mainfrom
codex/testing-target-state/el
Draft

elezar wants to merge 3 commits into
mainfrom
codex/testing-target-state/el

Conversation

@elezar

@elezar elezar commented Sep 18, 2026

Copy link
Copy Markdown
Member

Summary

Define the desired OpenShell testing model and the migration from host-managed and mise-managed integration tests to Nix-built artifacts and tmachine.

The document separates source validation, merge integration, specialized suites, and candidate-artifact release validation while recording the decisions that remain deferred.

Related Issue

No issue required: this is a documentation-only target-state clarification requested directly by a maintainer.

Changes

  • Define Nix environments for source checks and tmachine for integration and Linux installation validation
  • Separate platform, environment, configuration, installation, and testsuite axes
  • Define conformance, feature-specific, and driver-specific integration suites
  • Specify the initial fixed merge matrix and conditional SDK and packaging checks
  • Define candidate RPM, DEB, Snap, Helm, and existing Homebrew release-validation paths
  • Document the default local Ubuntu/Docker conformance cycle
  • Add a phased migration plan and an explicit deferred-decisions list
  • Relate the desired model to the current CI workflows and tmachine implementation

Testing

  • mise run pre-commit passes (not run: mise is unavailable in this environment)
  • Markdown lint passes for TESTING.md and CI.md using markdownlint-cli2 from Nix
  • git diff --check passes
  • nix flake show --no-write-lock-file passes
  • Unit tests added/updated (not applicable: documentation only)
  • E2E tests added/updated (not applicable: documentation only)

Checklist

  • Follows Conventional Commits
  • Commits are signed off (DCO)

Signed-off-by: Evan Lezar <elezar@nvidia.com>
@copy-pr-bot

copy-pr-bot Bot commented Sep 18, 2026

Copy link
Copy Markdown

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

Signed-off-by: Evan Lezar <elezar@nvidia.com>
Signed-off-by: Evan Lezar <elezar@nvidia.com>
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.

1 participant