Outline and review state maps each topic to its section, counts the checklist’s items by
mistake, and says how many claims have been reviewed. Verification report says how each
claim was checked.
How it stays consistent
- The field-by-field tables are generated from
corpus/fields.yamljoined with the corpus manifest, so the table agrees with the corpus by construction;make verify-guide OFFLINE=1fails when it does not. - Every normative sentence carries a claim tag, and
make repo-checksfails on a sentence with “must”, “never”, “should” or “do not” that has none. - The checklist and the linter share one registry: every xdrlint rule has a checklist item, and the checklist says how to check by hand what the linter cannot see.
make verify-guidealso runs the stellar-docs repository’s own format and link checks on the page, in a clone at the pinned commit.
Review before publication
Publication waits on a review by a core or platform engineer: every fact claimconfirmed or corrected, none
disputed. The reviewer package is built by guide/review/build.py. The current state is on
Outline and review state.