← 1.0.0 scope SAPE-16

sapedb.com: one page, every claim traceable to a file, and nobody has seen it render

Status
In progress
Component
docs
Priority
Medium — last thing up, after SAPE-15
Blocked by
SAPE-15
Blocks
—

Description

Finish and publish the front page. It is a single file. Two constraints were applied while writing it: the word faster and every speed number are banned, and every claim on the page must be answerable with the file that proves it. The page also has not been looked at — it has been written and saved, never rendered in front of a person.

Why now

It does not lose data and it does not break a public promise. It is here for the third reason: it is the first surface a stranger reaches, and a claim on it that turns out to be untrue costs the trust that every other ticket in this release is trying to earn. It goes up after SAPE-15 because it links into the learn site.

Measured 2026-09-20. projects/sapedb-site/www/index.html, one file, 39,660 bytes. The speed-number ban holds: no figure matching a duration, a multiplier or a throughput unit appears anywhere in it.

The word ban does not, literally. www/index.html:393 reads "Faster. The saving from fewer round trips has only been measured on loopback, where it is the same size as the difference between two runs of the same measurement, and nobody has measured it across a real network." It sits under a heading "What this is not sold as" — so the page is disclaiming the claim, not making it. The constraint as written is still broken, and whether the disclaimer is an allowed exception is a decision to record rather than to leave to whoever greps next. The honest words the page settles on are atomic, composable, and fewer round trips — K−1 of them for K steps, which is a count read off a declaration.

Acceptance criteria

  1. A person opens the page in a browser and reads it on a wide screen and on a phone. Nobody has done this. Until it happens the page is unreviewed, however carefully it was written.
  2. Every claim on the page has a file and a line that proves it, listed in one place, and each citation resolves — checked by opening them. A claim with no citation is cut, not rephrased.
  3. Zero occurrences of faster. Either the line at :393 is rewritten, or the exception for a disclaimer is written into the constraint and the check made to match it — but the check and the page agree.
  4. Zero speed numbers: no duration, no multiplier, no throughput unit. Run as a grep, so it can be run again.
  5. Every outbound link resolves, including every link into SAPE-15, checked against the published learn site rather than a local copy.
  6. The install instruction on the page is the one from SAPE-5, and was run from the page as written.

Out of scope