Skip to content

docs: deduplicate owner guides and remove stale workflow claims - #1723

Merged
luokerenx4 merged 2 commits into
devfrom
codex/documentation-workflow-cleanup
Oct 1, 2026
Merged

luokerenx4 merged 2 commits into
devfrom
codex/documentation-workflow-cleanup

Conversation

@luokerenx4

Copy link
Copy Markdown
Contributor

Summary

  • Deduplicate existing owner guides by linking to their canonical contracts; no guide split or new documentation file.
  • Reduce docs/development-workflow.md from 743 to 571 lines. Across nine Markdown files: 521 lines removed, 196 added (net -325).
  • Keep delivery authority, cumulative-diff verification, complete critical evidence, external-code isolation, signing boundaries, channel isolation and exact-candidate/stable upgrade gates intact.
  • Remove stale aggregate-check claims, qualify path-filtered dev CLI acceptance, correct stable-only managed-SSH release acceptance, and remove the retired Connector Docker gate.
  • Remove the dated model-preset audit inventory; current semantic facts and their sources remain owned by the registry and its maintenance rules.
  • Deduplicate CLI/remote/local lifecycle instructions and implemented-stage summaries. Retain still-implemented source fallback and shipped migration compatibility.

Verification

  • pnpm test:contract:workflow: 12 files, 104 tests passed; selector receipt accepted.
  • pnpm test:select --help and pnpm test:suites --tier e2e --explain: actual documented commands exercised successfully; discovery output is not product acceptance.
  • In-memory Markdown check: 182 local Markdown/wikilink destinations and heading anchors valid; fences balanced in all nine affected files. No throwaway files retained.
  • Checked current Actions predicates and existing CLI source-fallback implementation for the removed/corrected claims.
  • Incorporated current origin/dev; its intervening change only adds the version-lifecycle plan/index, not executable behavior.
  • No product, test, dependency or workflow implementation changed; owner typechecks, browser/native smoke and the full suite are not applicable to this documentation-only diff.

Boundary touch

  • Documentation of delivery/release/test contracts only; no trading, auth, persisted-state or signing execution changes.

Remote feedback

  • Previous integrated PR docs: plan version lifecycle convergence #1722 clean-build succeeded. Its dev publication was still running when inspected.
  • The older superseded dev run 36901121152 failed during dugite postinstall on a GitHub HTTPS connect timeout, not a product assertion. No release/build job was retried for this documentation change.

@vercel

vercel Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
openalice-demo Ready Ready Preview Oct 1, 2026 7:25pm UTC

Request Review

@luokerenx4
luokerenx4 merged commit 2bbcf87 into dev Oct 1, 2026
3 checks passed
@luokerenx4
luokerenx4 deleted the codex/documentation-workflow-cleanup branch October 1, 2026 19:25

This branch was successfully deployed

1 active deployment
Preview — a5ee3484 Deployed Oct 1, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant