docs: drop the method disclosure, keep the one caveat that earns its place

The "how these schools are chosen" panel restated what the section already
shows — the phase in the lede, the shared characteristics on each card, the
distance above each name — so it cost space to say nothing new.

One line survives, and it is not a method note. A reader who sees "0.6 miles
away" and takes it for the walk has been misled by us, and no other element
on the card corrects that. The rest were claims the selection rules keep
true without narrating them.

Also records what happens past the third school: surplus matches are dropped
silently, because NearbyPlaces below already leads to the full lists.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
TudorandClaude Opus 5 committed 2026-09-21 22:29:07 +01:00
1 parent 4d7762d796
commit b62dc17532
3 files changed
+46 -58

No files matched your search

@@ -105,6 +105,13 @@ the promise in the heading and a reader scanning the row reads the first card as
the closest. A tier-2 school at 0.4 miles therefore appears above a tier-1
school at 2.9 miles, and the chips explain the difference in match quality.
**More than three qualifying schools are dropped, not paginated.** In a dense
urban area dozens of schools clear tier 1, and the section shows the three
nearest of them. There is no "show more" and no count of what was left out,
because `NearbyPlaces` sits directly beneath and already answers "more schools
near here" by linking to the place pages — which are the pages built for
browsing a full list, and which the school page exists to feed.
**Fewer than two results renders nothing.** Not an empty state, not a single
lonely card, not padding with schools that failed the hard filters. The section
is absent, the nav item is absent, and the page is unchanged from today. A page
@@ -170,7 +177,7 @@ match the selection did not actually make.
`components/school/SimilarSchoolsSection.tsx` — a server component wrapped in
the shared `Section` shell from `sectionShared.tsx`. It renders the heading,
the lede, the `<details>` disclosure, the card grid and the footer CTA. Every
the lede, the card grid, the footer CTA and one caption line. Every
card's title is an `<a>` to the school's canonical slug URL via `schoolUrl()`.
`components/school/AddToCompareButton.tsx` — the only `'use client'` file this
@@ -228,11 +235,17 @@ reference line, and the reader draws their own conclusion.
em dash. This follows the same rule the rest of the detail page uses: a school
with no published result has not scored zero.
**The disclosure states the method plainly** — same phase, nearest first,
preferring a similar intake, special schools only ever compared with special
schools, straight-line distance from the school rather than road distance or
distance from the reader's home, and that being listed here is not a
recommendation.
**There is no "how these are chosen" disclosure.** The method is visible in what
the section already shows — the phase in the lede, the shared characteristics on
each card, the distance above each name — and a collapsed panel restating it
earns less than the space it costs.
**One caption line survives, and only one:** that distances are straight-line
from the school and not road distance. This is not a method note. A reader who
sees "0.6 miles away" and takes it for the walk has been misled by us, and no
other element on the card corrects that. The remaining notes — that listing is
not a recommendation, that special schools only meet special schools — are
statements the selection rules already keep true without being narrated.
## Degradation