docs/web の GitHub Pages 変更を PR 前に検証する時に使う。make html、linkcheck、Notebook の軽重分類、ja/en 構造差分、公開ブロッカーの切り分けをまとめて確認したい時に使う
docs/web の GitHub Pages 変更を、公開前または PR 前に検証するための skill。
manage_docs が一般的な doc build と同期を扱うのに対し、この skill は GitHub Pages 品質ゲートに特化する。
docs/web の build 成功を確認するja/en の構造差分を確認するcd docs && make html
sphinx-build -b linkcheck docs docs/_build/linkcheck
最低限、次を確認する。
ja/en の対応ページが両方存在する次は docs PR から分離して記録する。
cd docs && make htmlsphinx-build -b linkcheck docs docs/_build/linkcheckja/en 対応ページの同時更新検証結果は次の形式で残す。
その場合は web_docs_ia_overhaul または web_docs_page_rewrite を使う。