# Neith Linux Training Materials

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

1. Run the standard build/test/lint/fmt/nix-check command set against the Linux
   workspace.
2. Trace the recovery image and rollback path through the documented user flow.
3. 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
```

## Related Documentation

- [Neith Linux Overview](../README.md)
- [Neith Linux Developer Guide](../developer-guide.md)
- [Neith Linux User Guide](../user-guide.md)
- [Neith Training Program](../../training/README.md)
