Skip to content

docs!: rewrite docs short and current; drop ticket references (CL-8317) - #815

Merged
TheGreatAxios merged 1 commit into
mainfrom
docs-rewrite
Sep 17, 2026
Merged

TheGreatAxios merged 1 commit into
mainfrom
docs-rewrite

Conversation

@TheGreatAxios

Copy link
Copy Markdown
Contributor

Summary

  • Rewrote README.md, ARCHITECTURE.md, IMPLEMENTATION.md, PRODUCT.md against the current tree (Workbench as an Interchange client, mail-threaded chat, Myra as the one shipped agent), each under its line budget.
  • Stripped VENDORED.md's ledger to one sentence per row, removed ticket ids and the kill-date-test column.
  • Removed ticket references from DESIGN.md; content otherwise unchanged.
  • Deleted every docs/ file describing a retired feature or past decision (workbench tenancy, folded mail, onboarding connect cards, seed reconciliation, proposals, images, etc.).
  • Rewrote the four surviving docs/ files (GLOSSARY.md, local-dev.md, sidecar-provisioners.md, package-migrations.md) against the code, each under 60 lines.
  • Updated AGENTS.md's Docs map to list the surviving docs/ files.

Test plan

  • CI

@TheGreatAxios
TheGreatAxios merged commit f44a9ab into main Sep 17, 2026
3 of 4 checks passed
@TheGreatAxios TheGreatAxios changed the title docs!: rewrite docs short and current; drop ticket references docs!: rewrite docs short and current; drop ticket references (CL-8317) Sep 17, 2026
@linear-code

linear-code Bot commented Sep 17, 2026

Copy link
Copy Markdown

CL-8317

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