Report a Problem
Noticed something wrong but don't want to fix it yourself? This is the fast path: no writing, no pull request, just flag it and someone else takes it from here.
If you'd rather submit the actual fix yourself, correcting the text, adding the missing citation, see Submit a Change instead.
What to report here
- A factual error: a wrong figure, an outdated rule, a description that no longer matches the current guidance
- An unsourced claim: something that should carry the unsourced-claim flag⚠ but doesn't, or something flagged that you believe now has a source available
- A dead citation link: a source URL that no longer resolves or redirects somewhere unexpected
- An accessibility issue: anything that makes the publication harder to use with a screen reader, keyboard navigation, or at different zoom levels
How to report it
Open a GitHub issue using the issue template that matches what you're reporting: Factual error, Missing citation, Dead link, or Accessibility issue. Each template asks for the page URL and what's wrong, so a report can be triaged without back-and-forth. If your report doesn't fit any of those, a blank issue works too. You don't need a GitHub account to read an issue, but you do need one to open one, since that's how the maintainer can follow up with you if there are questions.
What happens after you report something
A reported error is checked against the same evidence-tier system used everywhere else in the guidebook: legal/regulatory sources outrank evidence-based sources, which outrank precedent-based ones. A dead citation link gets one of two treatments: if the source moved, the link is updated and an archive snapshot is kept as a backup; if the source is genuinely gone, the citation is re-flagged with the unsourced-claim flag until a replacement is found.
Reports don't require a response window or a guaranteed timeline, since this is a single-maintainer project, but every report is read and triaged.
Safety-relevant errors
If you're reporting something you believe could lead someone to make an unsafe real-world design decision, say so explicitly in the issue, the Factual error, Missing citation, and Dead link templates each ask directly. Those get looked at first.