Skip to content

feat(website): restructure the benchmark page into clearer sections#281

Merged
zantvoort merged 1 commit into
mainfrom
feat/benchmark-page-restructure
Jul 17, 2026
Merged

feat(website): restructure the benchmark page into clearer sections#281
zantvoort merged 1 commit into
mainfrom
feat/benchmark-page-restructure

Conversation

@zantvoort

@zantvoort zantvoort commented Jul 17, 2026

Copy link
Copy Markdown
Collaborator

Summary

Restructures /benchmarks for readability. No benchmark data, numbers, rankings, error margins, versions or benchmark source are changed — every value renders from the same WORKLOADS constant as before.

Sections

The page is reorganised under four clear headings: Performance results, Code comparison, Inspect each workload, and Methodology and reproduction. No content was removed.

Copy

  • New opening copy; a workload-coverage line at the top of the results.
  • First stat card now reads "fastest framework above JDBC" (and card 2 "fastest framework", for consistency and because not every compared library is a traditional ORM).
  • Network-overhead sentence reworded so it no longer implies a directly measured mapping overhead.
  • The LOC comparison keeps its numbers but is qualified as an illustration of these implementations, not a universal complexity measure.
  • A neutral Scope and limitations box (single-threaded latency on PostgreSQL; not throughput, pooling, startup, memory, native-image or other databases).
  • A closing call to action (Get started → /quickstart, View benchmark source → the benchmark repo).

Inspect each workload

Each workload shows Storm's implementation by default; the other six libraries are one <select> away and the SQL one "Show SQL" toggle away, both in the editor's own title bar (no extra panels or toggle links). The Show SQL toggle is keyboard-operable (role="button", tabindex, aria-expanded, Enter/Space) — the only accessibility gap in the editor chrome.

Verification

npm run build succeeds. Broken-link warnings in the build are pre-existing /docs/* versioned-docs anchors, unrelated to this change.

Reorganise /benchmarks under Performance results, Code comparison, Inspect
each workload, and Methodology and reproduction, without changing any
measured data.

- New opening copy and a workload-coverage line; the first stat card reads
  "fastest framework above JDBC".
- Reword the network-overhead sentence and give the JDBC round-trip figure as
  a 155-172 us range across sessions; qualify the LOC comparison.
- Add a Scope and limitations box and a closing call to action.
- Each workload shows Storm by default, the other six libraries a selector
  away and the SQL a keyboard-operable Show SQL toggle away.
@zantvoort
zantvoort merged commit 2f5f0d9 into main Jul 17, 2026
7 checks passed
@zantvoort
zantvoort deleted the feat/benchmark-page-restructure branch July 17, 2026 07:49
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