Skip to content

docs(engine-plan): status quo + remaining work; history split to its own doc - #7484

Merged
proggeramlug merged 2 commits into
mainfrom
docs/plan-statusquo-split
Aug 6, 2026
Merged

docs(engine-plan): status quo + remaining work; history split to its own doc#7484
proggeramlug merged 2 commits into
mainfrom
docs/plan-statusquo-split

Conversation

@proggeramlug

@proggeramlug proggeramlug commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Per review: the plan document should show the current state and what is left, not a running history.

Docs only.

Summary by CodeRabbit

  • Documentation
    • Restructured the engine plan into a concise current-state overview.
    • Moved historical status updates, incidents, measurements, and decision records into a dedicated history document.
    • Added links to related history and RFC documentation.
    • Updated current priorities, blockers, benchmark work, sequencing, and operational guidelines.
    • Preserved detailed engine-plan history through August 6, 2026.

Ralph Küpper added 2 commits August 6, 2026 06:27
… its own doc

The plan had grown to 811 lines, most of it dated status sections and
resolved incident narratives. It now holds only: the current state of the
four GC layers, the repsel stack position, the measured performance
backlog, the live gates/blockers, the ordered remaining work, and the
binding method rules distilled from the incidents. Everything dated moved
verbatim to docs/engine-plan-history.md as provenance.

Also reflects #7477 fixed by #7483 (merged): the DirectParser float
divergence is closed and #7478 is unblocked.
@proggeramlug
proggeramlug merged commit 34daed3 into main Aug 6, 2026
@proggeramlug
proggeramlug deleted the docs/plan-statusquo-split branch August 6, 2026 04:27
@coderabbitai

coderabbitai Bot commented Aug 6, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: fd58612d-71b8-4769-909d-314616190b90

📥 Commits

Reviewing files that changed from the base of the PR and between ee768b0 and b255dae.

📒 Files selected for processing (3)
  • changelog.d/7484-plan-statusquo-split.md
  • docs/engine-plan-history.md
  • docs/engine-plan.md

📝 Walkthrough

Walkthrough

The PR separates the current engine plan from its historical record. It adds a history document, updates the current status plan with active work and operating rules, and records the restructuring in the changelog.

Changes

Engine plan documentation

Layer / File(s) Summary
Historical engine-plan record
docs/engine-plan-history.md
Adds historical statepoint, platform, CI, rooting, RSS, performance, sequencing, and benchmark records.
Current engine-plan status
docs/engine-plan.md
Replaces embedded history with current GC status, representation-selection phases, benchmark priorities, blockers, ordered work, and operating rules. Links the current plan to the history and governing documents.
Changelog entry
changelog.d/7484-plan-statusquo-split.md
Documents the engine-plan restructuring and related issue references.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

  • PerryTS/perry#7292: Added related GC correctness and statepoint planning documentation.
  • PerryTS/perry#7293: Introduced changes to docs/engine-plan.md that this PR restructures.
  • PerryTS/perry#7482: Updated the current engine-plan status and sequencing that this PR consolidates.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/plan-statusquo-split

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

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