hidden11/docs/data-sources.md

Data Sources

Hidden11 uses a curated player dataset in data/players.json. The dataset is intentionally small enough to review manually, but each football fact should be checked against stable public sources before it is used in generated clues.

Source Hierarchy

Use this order when adding or updating players:

1. Current club and registered squad: Official league or club squad pages first. Examples include Premier League squad lists and official club squad pages.

2. Champions League titles: UEFA's official Champions League records and honour boards.

3. Domestic league titles and career clubs: Official league/club honour pages where available, then Wikidata/Wikipedia player pages for career history and honours.

4. Cross-check: For Medium and Hard clues, compare at least two public sources when a title count or former-club relationship decides a clue.

Public References

• UEFA Champions League all-time honours board: https://www.uefa.com/uefachampionsleague/news/0275-1541637ad1db-88aeeefefefd-1000--all-time-honours-board/

• UEFA Champions League all-time rankings: https://www.uefa.com/uefachampionsleague/history/rankings/

• Wikidata football data model: https://www.wikidata.org/wiki/Wikidata:WikiProject_Sports

• Wikidata member of sports team property: https://www.wikidata.org/wiki/Property:P54

Clue Rules

• Easy clues may mention current leagues, clubs and nationalities.
• Medium and Hard clues should avoid giving away current team or nationality.
• Medium and Hard may use historical relationships such as shared former clubs, title counts, title countries and Champions League comparisons.
• Do not use generic clues that apply to almost every player in the dataset, for example "both have played in top-flight football".

Maintenance

Run these commands after updating players or puzzles:

node scripts/generate-puzzles.mjs
npm run validate:data
npm run build