docs: catch the documentation up with what the site does

[hokiepokedad2]

Two swarms: ten agents auditing, thirteen writing and verifying. 101 findings, 30 files changed, 11 screenshots retaken.

What was wrong

35 of the findings were sentences that would mislead a reader today, not gaps:

• The in-app help told people to open "Areas & Location". That's been Areas & Places since refactor(where): Areas and Places are one surface #738.
• Alarm docs described the two-mode "Use Areas / Set Distance" delivery model that the per-alarm scope replaced.
• The change_types list for fort alarms omitted description.
• Quests had no filter documentation at all, so stardust and minimum amounts had nowhere to live.
• internationalization.md sent readers to a renamed page for a setting that had moved to the user menu.

The in-app help, in eleven languages

That content is 37–42k characters of HTML per locale. The audit found things a naive pass would have broken: fr.json is condensed rather than faithful (three bodies structurally shorter, alt texts still English), so every edit matched sentences by content, never by position. nl, pl and pt carry all 37 section headers in raw English — pre-existing, and not "fixed" wholesale here. Angular's sanitizer already strips the inline styles on the Pokemon colour pills, so no more were added.

Screenshots

Eleven retaken at 1440×900 against the running dev deployment, matching the existing house style. Four are new: the scope picker, the delivery chip on a card, the Places section, the Versions card.

Demo data — a pin, three saved places, four areas, six varied alarms — was seeded directly into the dev database rather than through the API, so the bot sent no DMs. The account has been restored to its exact prior state: pin back to 0,0, areas empty, ten original alarms, no places. Verified after.

The audit's advice that 35 of the 42 existing screenshots are referenced by nothing was followed: they were left alone.

Verification

Every claim the writers made was checked against the code by a separate adversarial pass. Nineteen failed and were corrected, including one this session had repeated in a PR description of my own: the update check is not the only outbound call PoracleWeb makes — MasterDataService fetches the masterfile from raw.githubusercontent.com on any visit. #760's description is wrong about that; the docs now aren't.

Others worth naming: custom_title isn't the only publicly visible setting (PublicKeys has five), DATA_DIR's default differs between its three consumers, and disable_user_geofences doesn't gate delete — a code finding that fell out of documenting it.

Also reconciled two places where the docs contradicted each other: where weather data comes from, and which writes still bypass the proxy.

Caught by the verifier, not by me

Two files came back with their line endings flipped CRLF→LF, which showed as a 246-line diff on a 16-line change. Restored, so the diffs show content.

Backend 1995 tests, frontend 1105, mkdocs build --strict clean.

Note on publishing: docs.yml deploys the site on pushes to main, so GitHub Pages won't change until a release ships.

https://claude.ai/code/session_01Nah4N2sGFs1TU2t7DXfKzJ