diff --git a/content/handoff.md b/content/handoff.md index 9ec525d..23214ee 100644 --- a/content/handoff.md +++ b/content/handoff.md @@ -178,13 +178,13 @@ sequenceDiagram ### Documentation focused workflow -| Phase | Owner | What happens (DoD) | Where | Status | -|:-----:|:---------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------------|:----------------| -| 1 | SME (R&D) | Provide doc packet/draft; link authoritative resources; answer questions.
DoD: packet sufficient for Docs to write a stub. | Issue | — | -| 2 | Docs | Create PR linked to issue with initial draft from packet.
DoD: doc exists in PR; missing info and questions tracked in issue. | PR (issue) | Stub | -| 3 | Docs | Turn stub into runnable draft.
DoD: ready for validation with explicit assumptions/unknowns. | PR | Unverified | -| 4 | SME (R&D) + Red Team | Parallel validation: SME verifies technical correctness; Red Team tests end-to-end; Docs implement changes.
DoD: SME approves and Red Team report = Pass. | PR | Verified by SME | -| 5 | Docs | Final editorial pass (structure, grammar, linters) and publish.
DoD: merged and published. | PR (merge) + issue | Verified | +| Phase | Owner | What happens (DoD) | Where | Status | +| :---: | :------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------- | :-------------- | +| 1 | SME (R&D) | Provide doc packet/draft; link authoritative resources; answer questions.
DoD: packet sufficient for Docs to write a stub. | Issue | — | +| 2 | Docs | Create PR linked to issue with initial draft from packet.
DoD: doc exists in PR; missing info and questions tracked in issue. | PR (issue) | Stub | +| 3 | Docs | Turn stub into runnable draft.
DoD: ready for validation with explicit assumptions/unknowns.
Note: Red team may be involved before this step to running through the draft. | PR | Unverified | +| 4 | SME (R&D) + Red Team | Parallel validation: SME verifies technical correctness; Red Team tests end-to-end; Docs implement changes.
DoD: SME approves and Red Team report = Pass. | PR | Verified by SME | +| 5 | Docs | Final editorial pass (structure, grammar, linters) and publish.
DoD: merged and published. | PR (merge) + issue | Verified | ---