docs: sync with code (topologies, mount scheme, CLI flags, UEFI/BIOS, fstab) and fix relative src links in docs/ to ../src/

docs/DEV_WORKFLOW.md

@@ -8,18 +8,18 @@ Goal
 Core Principles
 1) Contract-first per module
    - API signatures and responsibilities are documented in [docs/API-SKELETONS.md](docs/API-SKELETONS.md) and mirrored by crate modules:
-     - [src/types.rs](src/types.rs)
-     - [fn load_and_merge()](src/config/loader.rs:1), [fn validate()](src/config/loader.rs:1)
-     - [fn from_args()](src/cli/args.rs:1)
-     - [struct LogOptions](src/logging/mod.rs:1), [fn init_logging()](src/logging/mod.rs:1)
-     - [fn discover()](src/device/discovery.rs:1)
-     - [fn plan_partitions()](src/partition/plan.rs:1), [fn apply_partitions()](src/partition/plan.rs:1)
-     - [fn plan_filesystems()](src/fs/plan.rs:1), [fn make_filesystems()](src/fs/plan.rs:1)
-     - [fn plan_mounts()](src/mount/ops.rs:1), [fn apply_mounts()](src/mount/ops.rs:1), [fn maybe_write_fstab()](src/mount/ops.rs:1)
-     - [const REPORT_VERSION](src/report/state.rs:1), [fn build_report()](src/report/state.rs:1), [fn write_report()](src/report/state.rs:1)
-     - [struct Context](src/orchestrator/run.rs:1), [fn run()](src/orchestrator/run.rs:1)
-     - [fn detect_existing_state()](src/idempotency/mod.rs:1), [fn is_empty_disk()](src/idempotency/mod.rs:1)
-     - [struct CmdOutput](src/util/mod.rs:1), [fn which_tool()](src/util/mod.rs:1), [fn run_cmd()](src/util/mod.rs:1), [fn run_cmd_capture()](src/util/mod.rs:1), [fn udev_settle()](src/util/mod.rs:1)
+     - [src/types.rs](../src/types.rs)
+     - [fn load_and_merge()](../src/config/loader.rs:1), [fn validate()](../src/config/loader.rs:1)
+     - [fn from_args()](../src/cli/args.rs:1)
+     - [struct LogOptions](../src/logging/mod.rs:1), [fn init_logging()](../src/logging/mod.rs:1)
+     - [fn discover()](../src/device/discovery.rs:1)
+     - [fn plan_partitions()](../src/partition/plan.rs:1), [fn apply_partitions()](../src/partition/plan.rs:1)
+     - [fn plan_filesystems()](../src/fs/plan.rs:1), [fn make_filesystems()](../src/fs/plan.rs:1)
+     - [fn plan_mounts()](../src/mount/ops.rs:1), [fn apply_mounts()](../src/mount/ops.rs:1), [fn maybe_write_fstab()](../src/mount/ops.rs:1)
+     - [const REPORT_VERSION](../src/report/state.rs:1), [fn build_report()](../src/report/state.rs:1), [fn write_report()](../src/report/state.rs:1)
+     - [struct Context](../src/orchestrator/run.rs:1), [fn run()](../src/orchestrator/run.rs:1)
+     - [fn detect_existing_state()](../src/idempotency/mod.rs:1), [fn is_empty_disk()](../src/idempotency/mod.rs:1)
+     - [struct CmdOutput](../src/util/mod.rs:1), [fn which_tool()](../src/util/mod.rs:1), [fn run_cmd()](../src/util/mod.rs:1), [fn run_cmd_capture()](../src/util/mod.rs:1), [fn udev_settle()](../src/util/mod.rs:1)
 
 2) Grep-able region markers in code
    - Every module contains the following optional annotated regions:
@@ -55,22 +55,22 @@ Core Principles
 6) Module ownership and boundaries
    - Add a “Module Responsibilities” section in each module’s header doc comment summarizing scope and non-goals.
    - Example references:
-     - [src/device/discovery.rs](src/device/discovery.rs)
-     - [src/partition/plan.rs](src/partition/plan.rs)
-     - [src/fs/plan.rs](src/fs/plan.rs)
-     - [src/mount/ops.rs](src/mount/ops.rs)
-     - [src/report/state.rs](src/report/state.rs)
+     - [src/device/discovery.rs](../src/device/discovery.rs)
+     - [src/partition/plan.rs](../src/partition/plan.rs)
+     - [src/fs/plan.rs](../src/fs/plan.rs)
+     - [src/mount/ops.rs](../src/mount/ops.rs)
+     - [src/report/state.rs](../src/report/state.rs)
 
 7) Invariants and safety notes
    - For code that must uphold safety or idempotency invariants, annotate with:
      // SAFETY: explanation
      // IDEMPOTENCY: explanation
    - Example locations:
-     - [fn apply_partitions()](src/partition/plan.rs:1) must enforce empty-disks rule when configured.
-     - [fn make_filesystems()](src/fs/plan.rs:1) must not run if partitioning failed.
+     - [fn apply_partitions()](../src/partition/plan.rs:1) must enforce empty-disks rule when configured.
+     - [fn make_filesystems()](../src/fs/plan.rs:1) must not run if partitioning failed.
 
 8) Error mapping consistency
-   - Centralize conversions to [enum Error](src/errors.rs:1). When calling external tools, wrap failures into Error::Tool with stderr captured.
+   - Centralize conversions to [enum Error](../src/errors.rs:1). When calling external tools, wrap failures into Error::Tool with stderr captured.
    - Annotate mapping areas with:
      // ERROR: mapping external failure to Error::Tool
 
@@ -111,7 +111,7 @@ Checklist for adding a new feature
 - Add examples if config or output formats change
   - Update [config/zosstorage.example.yaml](config/zosstorage.example.yaml) or add a new example file
 - Keep error mapping and logging consistent:
-  - Ensure any external tool calls map errors to [enum Error](src/errors.rs:1)
+  - Ensure any external tool calls map errors to [enum Error](../src/errors.rs:1)
 - Run cargo build and update any broken references
 
 Optional automation (future)