Skip to content

SOURCES.md

Latest commit

 

History

History
62 lines (48 loc) · 3.09 KB

SOURCES.md

File metadata and controls

62 lines (48 loc) · 3.09 KB
Raw

Sources

All captures come from DBSC's published results on the Hal archive server, https://archive.halsail.com — a read-only, public, login-free archive that the HalSail subscription writes finished seasons to (a club can keep up to 20 yearly snapshots). It is a separate application from the live halsail.com site, with a different URL scheme and renderer.

Account and datasets

  • Account (DSKey owner): 1426 — Dublin Bay Sailing Club.

  • Datasets (one archived snapshot per season):

    DSKey Dataset
    3413 DBSC Summer Series 2025
    3264 DBSC Summer Series 2024
    3206 DBSC Summer Series 2023
    3123 DBSC Summer Series 2022

Endpoint family (all public GET, no auth/token)

The archive renders via a four-level AJAX cascade:

Endpoint Returns
GET /Result/_CrsResultSetDropDown/{account}?DSKey={ds} The account's archived datasets (the table above).
GET /Result/_CrsClassDropDown/{ds} Classes (fleets) in a dataset; option value = dataset-local ClassKey.
GET /Result/_CrsSeryDropDown/{ds}?ClassKey={c} The series available to that class — the class→series join, exposed nowhere else. Option value = SeriesKey.
GET /Result/_CrsResults/{ds}?SeriesKey={s} The results table fragment. SeriesKey is unique per (class × series) pair.

Keys are dataset-local small integers (a class is 13, not a global id), so they only mean anything in the context of their {ds}.

Provenance

Captured by scripts/halsail-archive-fetch.ts. Each sources/<year>/catalog.json records the exact source, account, dsKey, and fetchedAt for that dataset. The verbatim *.html files are stored unmodified for reproducibility.

The live-site (halsail.com) endpoint model, which this archive variant parallels, is documented at docs/notes/halsail/querying-public-results.md.

DBSC Yearbook (trophy winners)

Separate from the HalSail captures: the annual DBSC Yearbook (published with Afloat magazine) prints per-class "Trophy Winners" tables for the previous season. Editions hosted only on Issuu (no download) are transcribed manually from viewer screenshots; editions hosted as PDFs on dbsc.ie are transcribed from the PDF text layer. Everything lands in yearbook/<edition-year>/trophy-winners.md; each file records its source URL, page numbers, and method. See yearbook/README.md.

Edition Source
2026 (winners 2025) https://issuu.com/irelandafloatmagazine/docs/dbsc_2026_yearbook_
2025 (winners 2024) https://issuu.com/irelandafloatmagazine/docs/dbsc_yearbook_2025
2024 (winners 2023) https://www.dbsc.ie/wp-content/uploads/2024/04/DBSC_Yrbook_2024_small.pdf
2023 (winners 2022) https://www.dbsc.ie/wp-content/uploads/2023/04/DBSC_2023_-yearbook-download.pdf
2022 (winners 2021) https://www.dbsc.ie/wp-content/uploads/2022/03/dbsc_2022_yrbk_.pdf
2021 (winners 2020) https://issuu.com/irelandafloatmagazine/docs/dbsc_2021_
2020 (winners 2019) https://issuu.com/irelandafloatmagazine/docs/dbsc_2020_yearbook