Přeskočit na obsah

npm run verify:rules-catalog — Brána proti rozejití katalogu pravidel

Brána proti rozejití katalogu pravidel: Týž generátor v režimu kontroly: nic nezapíše, ale spadne, kdyby zápis něco změnil, kdyby vlastník pravidla přišel o hlavičku, nebo kdyby dokumentace odkazovala na pravidlo, které žádný validátor nevlastní.. npm skript, kontrola výstupů.

npm skript kontrola výstupů pipeline: check

Volání

npm run verify:rules-catalog

Spustí node scripts/dossier/build-rules-catalog.mjs --check (čteno z package.json při buildu)

Zdroj: scripts/dossier/build-rules-catalog.mjs

Týž generátor v režimu kontroly: nic nezapíše, ale spadne, kdyby zápis něco změnil, kdyby vlastník pravidla přišel o hlavičku, nebo kdyby dokumentace odkazovala na pravidlo, které žádný validátor nevlastní.

Kdy ho spustit

V build pipeline a před review; ručně kdykoli po zásahu do hlaviček validátorů nebo do generované stránky.

Co vynucuje

Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.

Co je potřeba vědět

  • Nezapisuje. Selhání znamená, že se generovaný výstup rozešel se svým zdrojem — spusť build:rules-catalog.
  • Chytá i opačný směr: text odkazující na pravidlo, které nikdo nevynucuje.

Vstupy a výstupy

Čte

  • data/generated/rules-catalog.json
  • content/pravidla/_index.md

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.