Complete documentation reconciliation and final review
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# Documentation reconciliation work
|
||||
|
||||
Status: reconciliation in progress.
|
||||
Status: all twelve documentation remediation units complete.
|
||||
|
||||
Date: 2026-10-07.
|
||||
|
||||
@@ -68,7 +68,8 @@ Owner: [01-cli-plan.md](01-cli-plan.md).
|
||||
- [x] Label superseded alternatives and dated sibling-checkout evidence clearly.
|
||||
Replace duplicated current contracts with concise summaries and canonical links.
|
||||
|
||||
**Completion:** Retired completed CLI work and reconciled obsolete choices; current contracts link to their owners and future work remains explicit.
|
||||
**Completion:** Retired completed CLI work and reconciled obsolete choices;
|
||||
current contracts link to their owners and future work remains explicit.
|
||||
|
||||
## D-02: reconcile dispatcher planning
|
||||
|
||||
@@ -84,7 +85,8 @@ Owner: [02-dispatch.md](02-dispatch.md).
|
||||
[consumer guide](../consumers/guide.md), and current mechanics to the internal
|
||||
overview. Preserve application migration work as separate future work.
|
||||
|
||||
**Completion:** Replaced pending dispatcher work with a completed planning record and links to implemented API, consumer, and internal owners.
|
||||
**Completion:** Replaced pending dispatcher work with a completed planning
|
||||
record and links to implemented API, consumer, and internal owners.
|
||||
|
||||
## D-03: reconcile backend planning
|
||||
|
||||
@@ -99,7 +101,8 @@ Owner: [03-backend.md](03-backend.md).
|
||||
and evidence tasks. Link current behavior to its owners; retain backend
|
||||
replacement and consumer adoption only as future work where applicable.
|
||||
|
||||
**Completion:** Recorded the implemented backend, retired completed adaptation tasks, and replaced singleton-rejection proposals with canonical references.
|
||||
**Completion:** Recorded the implemented backend, retired completed adaptation
|
||||
tasks, and replaced singleton-rejection proposals with canonical references.
|
||||
|
||||
## D-04: reconcile facade planning
|
||||
|
||||
@@ -115,7 +118,9 @@ Owner: [04-facade.md](04-facade.md).
|
||||
- [x] Keep old automated boundary-checker suggestions clearly historical or
|
||||
optional; do not turn them into a new implementation requirement.
|
||||
|
||||
**Completion:** Recorded facade completion, retired illustrative extra packages, and preserved backend replacement and proportionate-check considerations.
|
||||
**Completion:** Recorded facade completion, retired illustrative extra
|
||||
packages, and preserved backend replacement and proportionate-check
|
||||
considerations.
|
||||
|
||||
## D-05: close the preparation checklist
|
||||
|
||||
@@ -128,7 +133,8 @@ Owner: [initial-plan.md](initial-plan.md).
|
||||
- [x] Check the completed final handoff item and label the preparation process
|
||||
and recommended outline as historical planning material.
|
||||
|
||||
**Completion:** Closed the planning handoff, checked its final item, and labeled the retained process and outline as historical.
|
||||
**Completion:** Closed the planning handoff, checked its final item, and
|
||||
labeled the retained process and outline as historical.
|
||||
|
||||
## D-06: clarify completed feature and implementation records
|
||||
|
||||
@@ -146,7 +152,9 @@ Owners: [initial.md](initial.md) and [implementation.md](implementation.md).
|
||||
context. Keep diff/catalog and other genuine deferrals visible; completed
|
||||
design records must not become competing current API/CLI references.
|
||||
|
||||
**Completion:** Labeled feature specifications and staged instructions as completed history, linked current owners, and recorded later code fixes and selector-name behavior.
|
||||
**Completion:** Labeled feature specifications and staged instructions as
|
||||
completed history, linked current owners, and recorded later code fixes and
|
||||
selector-name behavior.
|
||||
|
||||
## D-07: correct the current CLI reference
|
||||
|
||||
@@ -166,7 +174,8 @@ Owner: [cli.md](../cli.md).
|
||||
CommandKit's standard-handler boundaries as well as returned by PromptKit.
|
||||
Preserve supported error identity and operational classification.
|
||||
|
||||
**Completion:** Corrected native marker/comment placement, qualified callback and engine lifecycle claims, and reconciled cancellation attribution.
|
||||
**Completion:** Corrected native marker/comment placement, qualified callback
|
||||
and engine lifecycle claims, and reconciled cancellation attribution.
|
||||
|
||||
## D-08: remove stale policy status statements
|
||||
|
||||
@@ -180,7 +189,8 @@ Owners: [testing.md](../policy/testing.md) and [oss.md](../policy/oss.md).
|
||||
- [x] Preserve policy rules and upstream provenance while correcting local
|
||||
implementation status. This work does not add testing or licensing gates.
|
||||
|
||||
**Completion:** Removed stale Go-suite and dependency-status claims while preserving policy rules, adopted versions, and upstream provenance.
|
||||
**Completion:** Removed stale Go-suite and dependency-status claims while
|
||||
preserving policy rules, adopted versions, and upstream provenance.
|
||||
|
||||
## D-09: correct the internal bridge description
|
||||
|
||||
@@ -192,7 +202,9 @@ Owner: [internal/overview.md](../internal/overview.md).
|
||||
- [x] Keep inventory/mechanics here and normative responsibility boundaries in
|
||||
the architecture policy.
|
||||
|
||||
**Completion:** Corrected neutral metadata/results flow and root callback ownership; distinguished adapter help rendering from standard inspection reports.
|
||||
**Completion:** Corrected neutral metadata/results flow and root callback
|
||||
ownership; distinguished adapter help rendering from standard inspection
|
||||
reports.
|
||||
|
||||
## D-10: reconcile navigation and reading guidance
|
||||
|
||||
@@ -205,7 +217,8 @@ Owners: [development.md](../development.md) and [README.md](../../README.md).
|
||||
- [x] Update README roadmap labels/navigation to match the reconciled statuses.
|
||||
Keep genuine future-work navigation discoverable without duplicating contracts.
|
||||
|
||||
**Completion:** Routed current work to canonical contracts and mechanics, labeled completed planning records, and exposed genuine deferrals separately.
|
||||
**Completion:** Routed current work to canonical contracts and mechanics,
|
||||
labeled completed planning records, and exposed genuine deferrals separately.
|
||||
|
||||
## D-11: remove temporary references from durable ADRs
|
||||
|
||||
@@ -222,21 +235,36 @@ Owners:
|
||||
must not change architectural decisions or manufacture new requirements.
|
||||
- [x] Confirm that no ADR retains a temporary-roadmap reference after the edits.
|
||||
|
||||
**Completion:** Removed all temporary-roadmap links from ADRs through editorial reference updates; accepted statuses, dates, and architectural choices remain unchanged.
|
||||
**Completion:** Removed all temporary-roadmap links from ADRs through editorial
|
||||
reference updates; accepted statuses, dates, and architectural choices remain
|
||||
unchanged.
|
||||
|
||||
## D-12: review the reconciled documentation
|
||||
|
||||
- [ ] Review every changed document against its canonical owner and current code.
|
||||
- [x] Review every changed document against its canonical owner and current code.
|
||||
Verify command spellings, defaults, outcomes, ownership, and report descriptions
|
||||
affected by the corrections.
|
||||
- [ ] Check local links and heading targets, including links affected by retiring
|
||||
- [x] Check local links and heading targets, including links affected by retiring
|
||||
sections. The audit found no unresolved local prose links or heading targets;
|
||||
preserve that result.
|
||||
- [ ] Check diffs for whitespace, stale references, and claims that delivered
|
||||
- [x] Check diffs for whitespace, stale references, and claims that delivered
|
||||
components are absent or superseded choices remain active requirements.
|
||||
Historical baselines and explicitly labeled rejected alternatives remain valid.
|
||||
- [ ] Confirm that deferred features are still identified accurately and that
|
||||
- [x] Confirm that deferred features are still identified accurately and that
|
||||
reconciliation introduces no new APIs, commands, guarantees, or consumer policy.
|
||||
- [ ] Record completion here and commit completed documentation units under the
|
||||
- [x] Record completion here and commit completed documentation units under the
|
||||
local commit policy. Use document review for this prose work; do not add tests
|
||||
or validation machinery solely to reconcile documentation.
|
||||
|
||||
**Completion:** Reviewed all changed documentation against current code and
|
||||
owners; local links, headings, whitespace, deferrals, and preserved ADR/policy
|
||||
scope checked.
|
||||
|
||||
## Final reconciliation evidence
|
||||
|
||||
All D-01 through D-12 items are complete. The completed records distinguish
|
||||
historical planning from implemented contracts and genuine future work. Review
|
||||
confirmed that only Markdown documents changed, accepted ADR metadata and
|
||||
architectural choices were preserved, and policy source/version provenance was
|
||||
retained. Local prose links and heading targets resolve; diff whitespace checks
|
||||
passed. No Go tests were added or run for this documentation-only work.
|
||||
|
||||
Reference in New Issue
Block a user