Skip to content

Docs: One current design per topic, superseded designs archived, ROADMAP cut to what is left - #30

Merged
b-re-w merged 2 commits into
developfrom
work/docs-consolidate
Oct 2, 2026
Merged

b-re-w merged 2 commits into
developfrom
work/docs-consolidate

Conversation

@b-re-w

@b-re-w b-re-w commented Oct 2, 2026

Copy link
Copy Markdown
Member

Closes #15

  • upcall-design / upcall-table-design / upcall-async-design -> docs/design/upcall.md (corrected against code while merging).
  • Superseded designs -> docs/archive/ with headers and an index.
  • Contradictions with code/SPEC corrected in architecture, binding-policy, marshalling, object-lifetime, downcall, wasm, threading, pyi-generation, kotlin-extensions, ecosystem.
  • ROADMAP 295 KB -> 29 KB: remaining items only, old section numbers kept so ~150 code citations resolve; history at 4ed9814.
  • ~195 references updated (comments, KDoc, two KSP message strings; no test asserts them).

check_guide 10/0, markdown link scan 150/0, library + KSP compile OK.

b-re-w added 2 commits October 3, 2026 07:15
…MAP cut to what is left

The three upcall documents merge into docs/design/upcall.md. Designs the code
no longer follows (the pythonx-synthesising adapter, the Pythonic stub product,
the PanamaPort plan, the 3.15t gate, old wasm and investigation narratives)
move to docs/archive/ with a superseded header. Design docs that contradicted
code or SPEC are corrected. ROADMAP goes from 295 KB to 29 KB: what is left,
keeping the old section numbers so code citations still resolve; history is in
git (4ed9814). References in code comments and docs follow the moves.
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