Skip to content

[Docs] Rename to "Why this fork is faster than stock Strata" and demonstrate it - #11

Merged
rwkeyes merged 1 commit into
dirigo/0.2.12-verifiedfrom
docs/why-ours-is-faster
Nov 13, 2026
Merged

rwkeyes merged 1 commit into
dirigo/0.2.12-verifiedfrom
docs/why-ours-is-faster

Conversation

@rwkeyes

@rwkeyes rwkeyes commented Nov 13, 2026

Copy link
Copy Markdown
Owner

Problem and result

## Why it is fast described the engine. The page's job in that slot is to make the fork's case against the release it
was ported to, so the section is renamed "Why this fork is faster than stock Strata" and rebuilt as an argument:
what is not faster, what is, by how much, why, the control that isolates the cause, how to reproduce it, and what it
does not show.

Related discussion

none — documentation only.

Approach

  1. Lead with the negative result. Both trees build engine 0.1.59; the eight-leg engine battery is within 1.1 %. The
    reader learns the claim rests on the server before seeing any gain, which is what makes the rest credible.
  2. Then the gain, with the chart, the absolute plus reciprocal table, and the work finished in the fixed window.
  3. Then the cause, as a contrast between what each server does at a fresh prompt.
  4. Then a control: on one 0.2.12 build, conv_route: shadow (classify and log, never switch) lands on stock's
    number, 934 ms at one stream, and conv_route: on lands on 727 ms. Same build, same card, same workload — the
    switch, not the build, moves the first token. Cited to DIRIGO.md, which carries both arms.
  5. Then reproduction: the two-arm script, the per-level JSON, and make-chart.py, which recomputes every figure on
    the page from those files.
  6. Then the limits, then one closing paragraph for the three engine decisions both versions share, since those are
    stock's and are explained in docs/HOW_IT_WORKS.md.
  7. The drafting table moved to What this fork changes, under "the same drafter, more control"; the extraction and
    suite results moved there too, as "two measured differences that are not speed".

Validation

Passed:

  • The control's numbers are the ones DIRIGO.md carries for the 0.2.12 pair (934 / 3 004 / 7 583 / 9 807 ms shadow
    against 727 / 2 640 / 6 114 / 9 758 ms on); the 934 vs 727 ms quoted is the one-stream pair, and the section says it
    is a different build from the 0.2.13 comparison.
  • The comparison's numbers are unchanged and still trace to dirigo-results/0.2.13-port/.
  • Links and anchors: the old #against-stock-v0213-on-the-same-card is gone from the page (0 occurrences); the new
    heading anchor resolves from Start here and from What this fork changes; no broken relative links.
  • Rendering: GitHub's Markdown API gives 8 tables and 2 images; the lookup=0|1 cell stays a single cell.

Failed:

none observed.

Not run:

  • No new measurement: the control is the 0.2.12 data already in the repo, the comparison is the 0.2.13 run.

Limits

  • The control comes from a different build and a different day than the headline comparison; it is labelled as such
    and is there to show the mechanism, not to add to the percentages.
  • One pass per arm; the drift bound is stated next to the numbers.

The section is the fork's case, so it should be named for it and built
like an argument rather than a description. It is now "Why this fork is
faster than stock Strata", and it demonstrates in this order:

1. what is NOT faster - both trees build engine 0.1.59 and the 8-leg
   engine battery lands within 1.1 %, so the reader knows the claim rests
   on the server before seeing a single gain;
2. the claim and its evidence - 739 vs 949 ms at one stream, the chart,
   the table with absolute and reciprocal columns, the work finished in
   the same window;
3. where it comes from - the two servers' behaviour at a fresh prompt;
4. a control - the same router measured shadow (934 ms, stock's number)
   against on (727 ms) on one build, so the switch rather than the build
   is shown to move the first token;
5. how to reproduce it - the harness, the per-level JSON, make-chart.py;
6. what it does not show - engine parity, conversations, 8 streams, the
   one-request granularity at 1 stream;
7. what both versions share underneath - one paragraph, since the engine
   decisions are stock's and belong to the shared explanation.

The drafting table moved to "What this fork changes", where a list of
differences belongs, under "the same drafter, more control"; the
extraction and suite results moved with it as "two measured differences
that are not speed". The old "Why it is fast" bullets are gone: the three
engine decisions now appear once, as the closing paragraph of the new
section.
@rwkeyes
rwkeyes merged commit 22b0de1 into dirigo/0.2.12-verified Nov 13, 2026
3 checks passed
@rwkeyes
rwkeyes deleted the docs/why-ours-is-faster branch November 13, 2026 17:39
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