Skip to content

docs: prune roadmap to forward-looking 1.0 plan - #186

Merged
rorygraves merged 1 commit into
mainfrom
chore/roadmap-weakness-audit
Apr 29, 2026
Merged

docs: prune roadmap to forward-looking 1.0 plan#186
rorygraves merged 1 commit into
mainfrom
chore/roadmap-weakness-audit

Conversation

@rorygraves

Copy link
Copy Markdown
Contributor

Summary

Stage 1–3 are done and the docs site is live. The roadmap had grown
to ~950 lines of historical narrative — Stage 1/2/3 sub-item
breakdowns, the Lanterna comparison tables, a long decision log, and
the "weaknesses originally identified at 0.1.x" audit (every item now
resolved). With the historical material no longer earning its weight,
this rewrite collapses the file to a forward-looking development
plan.

~950 lines → ~240 lines, focused on:

  • Vision + non-goals (kept, condensed)
  • Current state at 0.2.0 — single paragraph + capability bullets
  • Stage 4 — actual remaining work to ship 1.0: MiMa, sample-app gaps (`tree/`, `editor/`, `chat/` expansion), killer demo, `GridLayout` + `BorderLayout` (originally Stage 1, never landed), migration guide, DoD checklist
  • Stage 5 — Telnet + Web backends (post-1.0); explicitly-not-planned Swing/AWT and SSH preserved
  • Open questions narrowed to native image, 2.13 cross-publish, resize semantics, i18n, accessibility, Windows native
  • Lanterna reference collapsed to a few paragraphs (what we deliberately don't match; what we add over Lanterna)
  • Rolling "recent decisions" section (~3 months) replacing the full decision log

Removed entirely:

  • §4 Stage 1 / §5 Stage 2 / §6 Stage 3 sub-item work breakdown — all complete; git history is authoritative
  • §9 Lanterna comparison tables (component-by-component) — collapsed
  • §11 Decision log entries older than ~3 months
  • The 10-point "weaknesses originally identified at 0.1.x" table — every item was resolved by Stages 1–3 and now lives only as a footnote in the new "Current state" section

Test plan

  • `mdbook build` — clean (linkcheck enabled, zero broken links)
  • No source-code references; docs-only change
  • CI green on this PR

The roadmap had grown to ~950 lines of historical narrative covering
Stages 1–3, the Lanterna comparison reference, and a long decision
log. With Stages 1–3 complete and the docs site live, the historical
material no longer earns its weight.

Rewritten to ~240 lines focused on:

  - Vision + non-goals (kept, condensed)
  - Current state at 0.2.0 (one paragraph + capability bullet list)
  - Stage 4 — the actual work to ship: MiMa, sample-app gaps
    (tree/ editor/ chat-expansion), killer demo, GridLayout +
    BorderLayout (originally Stage 1, never landed), migration
    guide, 1.0 DoD checklist
  - Stage 5 — Telnet + Web backends, with explicitly-not-planned
    Swing/AWT and SSH preserved
  - Open questions — narrowed to native image, 2.13 cross-publish,
    resize semantics, i18n, accessibility, Windows
  - Lanterna reference — collapsed to a few paragraphs about what
    we deliberately don't match and what we add over Lanterna
  - Recent decisions (rolling, ~3 months) — replaces the long
    decision log

Removed entirely:
  - §4 Stage 1 / §5 Stage 2 / §6 Stage 3 detailed work breakdown
    (all complete; visible in git history)
  - §9 Lanterna comparison tables (collapsed)
  - §11 Decision log (replaced with a short rolling section)
  - The "weaknesses originally identified at 0.1.x" audit table
    (every item was resolved by Stages 1–3)
@codecov

codecov Bot commented Apr 29, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@rorygraves
rorygraves merged commit a323bbb into main Apr 29, 2026
4 checks passed
@rorygraves
rorygraves deleted the chore/roadmap-weakness-audit branch April 29, 2026 21:44
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