Training path for engineers and operators working on @neith/linux.
Audience#
- platform engineers extending flake, module, ISO, or crate behavior
- operators validating images, updates, rollback, and recovery paths
- contributors maintaining the self-hostability evidence chain
Learning Objectives#
- understand the implemented flake, module, package, ISO, and Rust workspace layout
- validate image, update, and rollback flows with reproducible commands
- recognize when a Linux change impacts self-hostability, SBOM, or release evidence
- document platform behavior clearly enough for downstream operators to verify
Curriculum#
Module 1: Workspace Orientation#
Walk the flake outputs, modules/neith/, iso/, packages/, and the crate
workspace. Identify which layer owns platform policy, publishing, and recovery.
Module 2: Verification Workflows#
Practice the fast verification path for configuration changes and the deeper
build/test path for behavior changes. Emphasize when to run nix-check versus
full image validation.
Module 3: Recovery And Evidence#
Rehearse update, rollback, and recovery scenarios, then map the resulting evidence back to the self-hostability and support-oriented documentation.
Hands-On Labs#
- Run the standard build/test/lint/fmt/nix-check command set against the Linux workspace.
- Trace the recovery image and rollback path through the documented user flow.
- Update a Linux-facing doc and identify the certification or SBOM artifact that would need to change alongside it.
Assessment And Evidence#
Successful completion means the trainee can:
- choose the correct verification target for a Linux change
- explain the difference between workstation behavior, update orchestration, and recovery tooling in the current footprint
- identify which Neith certification documents must move when Linux evidence changes
Commands Used In Training#
bash
pnpm nx run @neith/linux:build
pnpm nx run @neith/linux:test
pnpm nx run @neith/linux:lint
pnpm nx run @neith/linux:fmt
pnpm nx run @neith/linux:nix-check