Skip to content

docs: rebuild the README from scratch (perf-first, reimagined, no emdashes)#149

Merged
div0rce merged 1 commit into
mainfrom
docs/readme-reimagined
Jun 25, 2026
Merged

docs: rebuild the README from scratch (perf-first, reimagined, no emdashes)#149
div0rce merged 1 commit into
mainfrom
docs/readme-reimagined

Conversation

@div0rce

@div0rce div0rce commented Jun 25, 2026

Copy link
Copy Markdown
Owner

Summary

Complete ground-up rewrite of the README. The old one opened with a plain title and prose and buried the flamegraph and benchmark numbers near the bottom. The new one leads with the visuals and the numbers.

What changed:

  • Centered header with a tagline and six status badges (CI, C++20, tests, sanitizers, determinism, license).
  • "The numbers" up top: a side-by-side before/after perf table (throughput, p99 latency, cycles/order, branch-miss rate) plus a quality-bar table, linking PERFORMANCE.md.
  • The flamegraph is now a hero image near the top, not an afterthought, with a pointer to the before/after call graphs.
  • New "What is actually interesting here" section (determinism, the OCaml oracle, profile-then-optimize-then-prove, hardening).
  • Microbenchmarks, architecture (mermaid), quickstart, differential testing, honest limits, layout, and positioning follow.

Constraints honored:

  • No emdashes or en-dashes anywhere (verified: 0 of each).
  • All internal links resolve; HTML tags balanced; "9 CLI tools" / "271 tests" accurate to current main.

Second commit refreshes the dpdk/nic_offload env-check artifacts, which carry README.md in their provenance digest scope.

🤖 Generated with Claude Code

Complete ground-up rewrite. The old README opened with a plain title and prose
and buried the flamegraph and benchmark numbers near the bottom. The new one:

- Centered header block with a tagline and six status badges (CI, C++20, tests,
  sanitizers, determinism, license).
- Leads with "The numbers": a side-by-side before/after perf table (throughput,
  p99 latency, cycles/order, branch-miss rate) and a quality-bar table, linking
  PERFORMANCE.md.
- The matching-engine flamegraph is now a hero image near the top, not an
  afterthought, with a pointer to the before/after call graphs.
- New "What is actually interesting here" section framing the real signals
  (determinism, the OCaml oracle, profile-then-optimize-then-prove, hardening).
- Microbenchmarks, architecture (mermaid), quickstart, differential testing,
  honest limits, layout, and positioning follow.

No emdashes or en-dashes anywhere (verified). All internal links resolve; HTML
tags balanced.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@coderabbitai

coderabbitai Bot commented Jun 25, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@div0rce, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 44 minutes and 58 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 5ef5925e-7443-4e0e-acc3-ccd49d2ede9e

📥 Commits

Reviewing files that changed from the base of the PR and between 64645fb and 6b7add1.

📒 Files selected for processing (1)
  • README.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/readme-reimagined

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.

@codescene-delta-analysis codescene-delta-analysis Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No application code in the PR — skipped Code Health checks.

See analysis details in CodeScene

Quality Gate Profile: Pay Down Tech Debt
Install CodeScene MCP: safeguard and uplift AI-generated code. Catch issues early with our IDE extension and CLI tool.

@div0rce div0rce merged commit da35fef into main Jun 25, 2026
8 checks passed
@div0rce div0rce deleted the docs/readme-reimagined branch June 25, 2026 03:22
div0rce added a commit that referenced this pull request Jun 25, 2026
* chore(release): cut v0.2.2

Finalize the v0.2.2 changelog entry to include this session's documentation
overhaul (#147), performance-evidence report (#148), README rebuild (#149), and
the bug/style/mermaid sweep (#150) on top of the post-v0.2.1 hardening + perf
wave (#135-#146). Fix the test count (272/272) and flip the v0.2.2 resume/release
anchors (PROGRESS.md, release_readiness.md) from "in preparation" to released.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: reconcile test count to 272/272 across release records (CodeRabbit)

CodeRabbit flagged docs/release_readiness.md still showing 270/270 while
CHANGELOG/PROGRESS said 272/272. The two perfeval tests added this session took
the count 270 -> 272, so the current-state and verification claims were stale.
Updated all current-state references (release_readiness verification table,
PROGRESS.md status + both summary blocks, the CLAUDE.md/AGENTS.md roadmap memory
kept in sync, HANDOFF.md), and flipped the v0.2.2 "being cut / next action"
phrasing to released. The one remaining 270/270 is a dated entry under
PROGRESS.md "Decision log additions" (a correct historical snapshot). All
em-dash-free.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
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