Task 03: Update Operator Documentation

Intent

Document the retained-generation and missing-payload behavior in the existing Storage maintenance how-to guide.

Acceptance

The guide states that one active Go-cache quarantine generation defers another rotation without failing maintenance.
The guide states that permanent deletion can close an absent payload without changing the live cache, while restore remains fail-closed.
Public-document validation passes, and the plan records all task results.

Files Likely Touched

docs/public/operations.md
docs/plans/go-cache-quarantine-lifecycle/plan.md
docs/plans/go-cache-quarantine-lifecycle/task-01-defer-retained-rotation.md
docs/plans/go-cache-quarantine-lifecycle/task-02-close-missing-payload.md
docs/plans/go-cache-quarantine-lifecycle/task-03-update-operator-docs.md

Dependencies

Task 01: final deferral result fields and semantics.
Task 02: final deletion and byte-accounting semantics.

Parallelism

sequential.

Inputs

Spec sections: Go build cache, Failure modes, and Scenarios.
Plan section: Public Documentation.
Public page type: how-to guide.

Verification

node --test scripts/validate-public-docs.test.mjs && node scripts/validate-public-docs.mjs && git diff --check

Output Contract

Report the documentation changes, exact validation outcomes, public-doc type, cleanup evidence, remaining risks, and synchronized task and plan status.

Results

Updated docs/public/operations.md with the one-active-generation deferral result and the missing-payload deletion, zero-byte accounting, and fail-closed restore behavior.
Public page type: how-to guide.
node --test scripts/validate-public-docs.test.mjs && node scripts/validate-public-docs.mjs && git diff --check passed (60 validation tests and 41 published pages).

2.1 KiB Raw Blame History