Resources & guides
The public site includes a Resources section at https://sailboat.racing/resources — guides and
free calculators about sailing race scoring, aimed at sailors and race officers. It is separate from
this system documentation (which lives at docs.sailboat.racing). It is reachable from the main site
navigation (header and footer) on every page.
Portsmouth Yardstick
The first cluster covers the Portsmouth Yardstick, at /resources/portsmouth-yardstick:
- How it works — what a Portsmouth Number is and where the numbers come from.
- How returns work — how clubs' results feed the RYA's annual recalculation.
- Corrected time formula — how the
elapsed × 1000 ÷ PNformula works, with a worked example. - Corrected time calculator — enter boats, sail numbers, and elapsed times to rank a full fleet by corrected time (uses national PY numbers).
- Pursuit race calculator — standalone staggered start-time calculator using national PY numbers.
- Average lap racing — scoring boats that sail different numbers of laps, including the Same PN adjustment.
- Average lap calculator — enter boats with class, sail number, elapsed time, and lap count to rank a fleet by corrected time with the Same PN adjustment applied automatically (uses national PY numbers).
- Club adjustments — when and how to adjust national numbers or set your own.
- National PY number lists — the full RYA Portsmouth Yardstick list for each year held in the
system (e.g. 2025, 2026), sourced from the public handicap lists named
RYA PY List <year>.
The explainer pages are authored as Markdown; the calculators and number lists are server-rendered
pages. All are included in the sitemap and llms.txt so search engines and AI tools can find them.
How content is authored
Prose guides are Markdown files under web/src/main/resources/content/, with YAML front-matter
(title, description, optional updated, noindex, and an faq list that becomes FAQ structured
data). Interactive calculators and the national number lists are server-rendered pages. A content
registry keeps routing, the sitemap, and llms.txt in sync, so new guides appear everywhere
automatically.