書籍品質向上（誤字脱字/文字種/リンク/レイアウト）実行計画 + 全書籍チェックリスト

[ootakazuhiko]

書籍品質向上（誤字脱字/文字種/リンク/レイアウト） 実行計画

現状（2026-02-16 時点）

• 自動検査（Book QA）を全28冊へ導入済み（+ linux-infra-textbook は旧版/アーカイブ）（Unicode / textlint(PRH) / 内部リンク・アンカー / layout risk scan（long lines/tables/images/unclosed fences） / Jekyllビルド / built-site smoke）
• textlint(PRH) は高確度ルールのみ --fail-on error でブロック運用に更新済み
• 再スキャン結果: 全書籍で検出0（Unicode/textlint/内部リンク・アンカー）; layout risk scan: errors=0 / warnings=0（maxCodeLineLength=200）
• GitHub Pages スモーク: 全書籍でトップURLと共通アセットのHTTP 200を確認済み
• GitHub Pages 導線確認: navigation.yml 由来の主要ページでHTTP 200を確認済み
• PRテンプレ（QA結果/Pages確認URL/影響範囲）を全書籍へ導入済み
• book-formatter pin 更新（book-formatter#74: b7e85c4）を全28冊へ反映完了（マージ済み、反映確認済み）
• GitHub Pages の Built with ... 表記を book-formatter に統一（旧: book-publishing-template2 参照を解消）
  • https://github.com/itdojp/BioinformaticsGuide-book/pull/190
  • docs: Built with を book-formatter に更新 computational-physicalism-book#115
  • docs: Built with を book-formatter に更新 cs-visionaries-book#109
  • docs: Built with を book-formatter に更新 github-guide-for-beginners-book#179
  • docs: Built with とリポジトリリンクを現行に更新 github-workflow-book#197
  • docs: Built with を book-formatter に更新 podman-book#167
  • docs: Built with を book-formatter に更新 supabase-architecture-patterns-book#121
• EOL環境例の残存確認（git grep）: ubuntu:20.04 / Ubuntu 20.04 / amazonlinux:2 / Amazon Linux 2 は全28冊のデフォルトブランチで検出0
• Markdown structure check を全28冊で再スキャンし、issues 0（errors/warnings 0）を確認
• 品質スプリントIssueの自動起票（隔週: 1日/15日）を導入済み（quality-sprint-reminder）
• 品質スプリントIssue [Quality Sprint] 2026-02-08 #105/[Quality Sprint] 2026-02-15 #109 は完了クローズ済み（2026-02-16 時点）
• linux-infra-textbook は linux-infra-textbook2 に置換された旧版（アーカイブ/一覧から除外）として扱う（以降の改善は linux-infra-textbook2 を正とする）
• 残作業:
  • 内容の正誤レビュー（バージョン依存/EOL/非推奨/公式リンクの棚卸し）
    • Ubuntu 20.04 / Amazon Linux 2 の残存例を更新（22.04/24.04 + Amazon Linux 2023）
    • その他（言語/ツール/クラウドのEOL・非推奨、公式リンク更新）
  • （必要なら）Markdown/構造lintのCI統合（見出しレベル/Front Matter/コードフェンス言語等）
  • 品質スプリントの継続実施（quality-sprint-reminder）

概要

一覧の書籍について、誤字脱字（日本語として不適切なUnicode文字混入を含む）、事実誤認、リンク切れ、Markdown構造不整合、図表/表/コードのレイアウト崩れを継続的に低減するための計画。

ゴール（受入条件）

• 各書籍で book-formatter ベースのQA（自動検査）がCIで実行され、P0/P1をFailとしてブロックできる
• 各書籍でQAを1周し、検出事項（P0/P1優先）を修正してGitHub Pagesで正常表示を確認する
• 以降は運用（定期スキャン＋小PR）で品質劣化を抑止する

品質観点（チェック項目）

自動検査（CIで実施）

• Unicode品質: 不可視文字、互換漢字/互換文字、全角英数、IVS/異体字、紛らわしい記号の検出（疑わしい箇所の一覧化＋例外許容リスト）
• 文章校正: textlint + prh（共通辞書 + 書籍固有辞書）
• Markdown/構造: 見出しレベル飛び、Front Matter、コードフェンス言語、Mermaidフェンス、箇条書き崩れ等
• リンク: 内部リンク/アンカーはFail、外部リンクは原則Warn（不安定要因のため）
• ビルド/表示: ビルド成功＋GitHub Pages smoke（トップ200/主要導線の最低限の到達性）

注: 現時点でCIに統合済みなのは Unicode / textlint(PRH) / 内部リンク・アンカー / layout risk scan（long lines/tables/images/unclosed fences） / Markdown/構造lint（見出しレベル/Front Matter/コードフェンス言語等） / Jekyllビルド / built-site smoke（navigation + 共通アセット） までです。（デプロイ後の）GitHub Pages HTTP スモークは未統合です。

手動確認（PRの受入条件）

• 図表/表/画像のはみ出し、コードブロック横スクロール、モバイル表示（主要ページ）
• 内容の正誤（バージョン依存、非推奨/廃止、公式リンク、EOL等）
• 引用/出典/ライセンス表記の整合（CC BY-NC-SA + 商用別契約の前提）

優先度定義（運用ルール）

• P0: ビルド不可 / Pages表示不可 / 重要ページ404 等（最優先で即修正）
• P1: 内部リンク切れ、ナビ破綻、誤情報の明確な指摘 等（次優先で修正）
• P2: Unicode疑義、表記ゆれ、軽微な構造不整合 等（計画的に修正）
• P3: スタイル改善、冗長表現、リライト 等（余力で対応）

実行計画

Phase 0: 基準整備（メタ合意）

• QAコマンドと合否条件（Fail/Warn）を確定
• 共通辞書/ルールの置き場と更新フロー（book-formatter→各書籍）を定義
• 例外許容の方針（専門用語、固有名詞、外部リンクの扱い）を定義

Phase 1: book-formatter整備（自動検査の中核）

• Unicode品質検出（疑義箇所レポート＋許容リスト）
• textlint/prh（共通＋書籍固有）統合
• 内部リンク/アンカーチェック（Fail）
• layout risk scan（long lines / tables / images / unclosed fences）
• Pages smoke（トップURL + 共通アセットのHTTP 200）
• ビルド（Jekyll）＋導線スモーク（トップ200/主要導線）をCIに統合
• CIテンプレ/導入手順を整備（README/TROUBLESHOOTING更新）

Phase 2: 各書籍への適用（小粒PRで積み上げ）

• 原則「カテゴリ別の小PR」（Unicode/リンク/構造/文章/レイアウト）に分割し、レビュー観点を分離
• P0/P1を優先して修正し、Pagesで表示確認（PC/モバイル）

Phase 3: 継続運用（劣化抑止）

• PRテンプレに「QA結果」「Pages確認URL」「影響範囲」を必須化
• 月次/隔週で品質スプリント（P2/P3消化、外部リンク棚卸し）
• book-formatter pin 更新（book-formatter#74: b7e85c4）の全書籍への横展開（PR一覧は Issue コメント参照）
• book-formatter更新時の横展開手順（追随PRの作法）を固定化（docs/publishing/operations-playbook.md）

Phase 2.1: 追加（Markdownコードフェンス整合性）

layout risk scan に unclosed code fences 検出を追加（book-formatter#73）した上で、既存の崩れを個別修正して表示不具合の潜在リスクを低減する。

• itdojp/cloud-infra-book: fix(docs): fix code fence balance cloud-infra-book#85
• itdojp/formal-methods-book: fix(docs): fix code fence balance formal-methods-book#145
• itdojp/linux-infra-textbook: https://github.com/itdojp/linux-infra-textbook/pull/106 ※旧版/アーカイブ（linux-infra-textbook2 に置換）
• itdojp/linux-infra-textbook2: fix(docs): fix code fence balance linux-infra-textbook2#93
• itdojp/supabase-architecture-patterns-book: fix(docs): fix code fence balance supabase-architecture-patterns-book#98
• itdojp/IT-engineer-communication-book: fix(docs): fix nested code fences IT-engineer-communication-book#100

Phase 2.2: 追加（EOL環境例の除去: Ubuntu 20.04 / Amazon Linux 2）

方針「20.04向け手順は削除して22.04/24.04のみ残す」「Amazon Linux 2023版とする」に合わせ、残存する例を更新する。

• itdojp/cloud-infra-book: docs: update base image examples (Ubuntu 22.04/24.04, AL2023) cloud-infra-book#90
• itdojp/IT-infra-book: docs: update Dockerfile examples to Ubuntu 24.04 IT-infra-book#112
• itdojp/formal-methods-book: docs: update Dockerfile examples to Ubuntu 24.04 formal-methods-book#147
• itdojp/formal-methods-book: docs: replace Ubuntu 20.04 examples formal-methods-book#149
• itdojp/cs-visionaries-book: docs: update Dockerfile example to Ubuntu 24.04 cs-visionaries-book#98

Phase 2.3: 追加（EOLランタイム/イメージの更新: Node.js 18 / Python 3.9 / Ruby 2.7/3.0）

OSに加えて、言語/ツール/コンテナイメージのEOL例（Node.js 18 / Python 3.9 / Ruby 2.7/3.0 等）を更新する。

• itdojp/BioinformaticsGuide-book: https://github.com/itdojp/BioinformaticsGuide-book/pull/178
• itdojp/IT-infra-book: fix(docs): update Node.js prerequisite IT-infra-book#114
• itdojp/IT-infra-troubleshooting-book: fix(docs): update Node.js requirement IT-infra-troubleshooting-book#107
• itdojp/LogicalThinking-AI-Era-Guide: fix(docs): update Node.js prerequisite LogicalThinking-AI-Era-Guide#99
• itdojp/ai-testing-strategy-book: fix(docs): update Node.js requirement ai-testing-strategy-book#137
• itdojp/cloud-infra-book: fix(docs): update Python container base image cloud-infra-book#92
• itdojp/computational-physicalism-book: fix(docs): update Node.js requirement computational-physicalism-book#110
• itdojp/cs-visionaries-book: fix(docs): update Node.js requirement cs-visionaries-book#100
• itdojp/formal-methods-book: fix(docs): update Node.js prerequisite formal-methods-book#150
• itdojp/github-guide-for-beginners-book: fix(docs): update Node.js container image examples github-guide-for-beginners-book#168
• itdojp/github-workflow-book: fix(docs): refresh Python/Django versions in examples github-workflow-book#174
• itdojp/it-infra-security-guide-book: fix(docs): update Node.js container base image it-infra-security-guide-book#109
• itdojp/it-infra-software-essentials-book: fix(docs): update Ruby/Node prerequisites it-infra-software-essentials-book#98
• itdojp/linux-infra-textbook2: fix(docs): update EOL runtime versions in examples linux-infra-textbook2#98
• itdojp/podman-book: fix(docs): update EOL container images in examples podman-book#156
• itdojp/practical-auth-book: fix(docs): update Node.js requirement practical-auth-book#105
• itdojp/supabase-architecture-patterns-book: fix(docs): update Node.js prerequisite supabase-architecture-patterns-book#101
• itdojp/theoretical-computer-science-textbook: fix(docs): update Ruby/Node prerequisites theoretical-computer-science-textbook#238

Phase 2.4: 追加（残存 Python 3.9 ランタイム例の更新）

追加スキャンで検出した python3.9 の残存記述を python3.12 に更新する。

• itdojp/cloud-infra-book: fix(docs): update Lambda runtime examples to python3.12 cloud-infra-book#105
• itdojp/linux-infra-textbook2: fix(docs): update Terraform Lambda runtime example to python3.12 linux-infra-textbook2#109

---

全書籍チェックリスト（消し込み用）

各書籍で最初の1周は下記を全て実施。修正PRはカテゴリ別に分割する。

itdojp/BioinformaticsGuide-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/IT-engineer-communication-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/IT-infra-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/IT-infra-troubleshooting-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/LogicalThinking-AI-Era-Guide

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/ai-communication-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/ai-era-engineers-mind-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/ai-testing-strategy-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/cloud-infra-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/computational-physicalism-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/cs-visionaries-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/ethereum-learning-bootcamp

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/formal-methods-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/github-guide-for-beginners-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/github-workflow-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/illustrated-linux-basics-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/it-infra-security-guide-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/it-infra-software-essentials-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/linux-infra-textbook（旧版/アーカイブ: linux-infra-textbook2 に置換）

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/linux-infra-textbook2

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/negotiation-for-engineers-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/pentest-learning-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/podman-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/practical-auth-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/proxmox_book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/small-webapp-software-design-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/supabase-architecture-patterns-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/theoretical-computer-science-textbook

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

itdojp/wsl2-linux-essentials-book

• QA実行（Unicode/textlint(PRH)/内部リンク・アンカー）
• 検出事項の修正（P0/P1優先）※現時点の検出0
• レイアウト確認（headless render: PC/モバイル、図表/表/コード中心）
• GitHub Pagesスモーク（トップURL + 共通アセット）
• GitHub Pages確認（トップ200、主要導線）

[ootakazuhiko]

進捗共有（Phase 1/2）

Phase 1: book-formatter（Unicode品質検出）

• Unicode品質チェッカーを追加するPRを作成済み: feat(qa): add unicode quality checker book-formatter#59
  • 検出対象: U+FFFD、制御文字、一部不可視文字、互換漢字、異体字セレクタ（VS Supplement: U+E0100..）、全角英数字、マイナス記号（U+2212）
  • ノイズ抑制: 絵文字用途が多い VS1-16（U+FE00..U+FE0F）は対象外、ZWJ/ZWNJは warning 扱い

Phase 2: 書籍側のP0/P1（error）対応

• 相当の検出で、error が出ていた書籍にPR作成済み
• fix(docs): replace replacement chars with explicit surrogate escape ai-testing-strategy-book#124: U+FFFD（��）を に置換（意図の明確化）
• fix(docs): replace zero-width space with explicit escape practical-auth-book#93: U+200B（Zero-width space混入）を 表記に置換（意図の可視化）

スキャン結果（現状）

• error: 上記2冊以外は 0（ローカルで を使用）
• warning: に U+2212 が残（44件）など

[ootakazuhiko]

進捗共有（Phase 1/2）※直前コメントはシェル展開で一部欠落したため再掲

Phase 1: book-formatter（Unicode品質検出）

• Unicode品質チェッカーを追加するPR: feat(qa): add unicode quality checker book-formatter#59
  • 検出対象: U+FFFD、制御文字、一部不可視文字、互換漢字、異体字セレクタ（VS Supplement: U+E0100..U+E01EF）、全角英数字、マイナス記号（U+2212）
  • ノイズ抑制:
    • 絵文字用途が多い VS1-16（U+FE00..U+FE0F）は対象外
    • ZWJ/ZWNJ（U+200D/U+200C）は warning 扱い

Phase 2: 書籍側のP0/P1（error）対応

• check-unicode --fail-on error 相当で error が出ていた書籍にPR作成
  • fix(docs): replace replacement chars with explicit surrogate escape ai-testing-strategy-book#124: U+FFFD（"��"）を "\ud800" に置換（意図の明確化）
  • fix(docs): replace zero-width space with explicit escape practical-auth-book#93: U+200B（Zero-width space混入）を \u200b 表記に置換（意図の可視化）

スキャン結果（現状・ローカル計測）

• error: 上記2冊以外は 0
• warning: theoretical-computer-science-textbook に U+2212 が残（44件）など

[ootakazuhiko]

進捗更新（Phase 2 / ai-testing-strategy-book）

• fix(docs): replace replacement chars with explicit surrogate escape ai-testing-strategy-book#124 はレビュー指摘に基づき、"\\ud800" ではなく以下の形に修正しました（Pythonで実行可能かつ意図が明確）
  • b"\\xed\\xa0\\x80".decode("utf-8", errors="surrogatepass")
• CIは再実行後にすべて成功（mergeable: CLEAN）を確認済み

[ootakazuhiko]

進捗更新（Phase 1/2: Unicode warning 低減）

Phase 1: book-formatter（Unicodeチェッカー改善）

• fix(qa): make node_modules ignore work in check-unicode book-formatter#60
  • check-unicode の glob 実装を修正し、node_modules 配下を正しく ignore できるようにしました（依存パッケージのREADME等で誤検知する問題を回避）。

Phase 2: 書籍側（warning 低減）

• chore(qa): allowlist U+2212 minus sign theoretical-computer-science-textbook#226
  • 理論計算機科学教本は数式表記で U+2212 を意図的に使用しているため、unicode-allowlist に追加して warning を抑制。
• fix(docs): replace U+2212 with ASCII hyphen IT-engineer-communication-book#90
  • U+2212 を ASCII "-" に統一（src/docs 同期）。
• fix(docs): remove ZWJ (U+200D) from emojis supabase-architecture-patterns-book#87
  • 絵文字シーケンス内の ZERO WIDTH JOINER (U+200D) を除去（src/docs 同期）。
• fix(docs): remove ZWJ (U+200D) from emoji github-workflow-book#157
  • DIRECTORY_STRUCTURE.md の ZERO WIDTH JOINER (U+200D) を除去。
• https://github.com/itdojp/BioinformaticsGuide-book/pull/162
  • 全角数字（U+FF12）を半角へ統一、ZERO WIDTH JOINER (U+200D) を除去。

全PRはCI成功・コンフリクトなし（mergeable: CLEAN）を確認しています。

[ootakazuhiko]

Unicode再スキャン結果（全書籍）

book-formatter: b38f6f1
node: v22.19.0

• 対象: existing-books.md に記載の28冊 + linux-infra-textbook2
• 実行: book-formatter/scripts/check-unicode.js（pattern: **/*.md, fail-on: none, node_modules は ignore）
• 結果: 全書籍で errors=0 / warnings=0 / fileReadErrors=0

TSV（repo\terrors\twarnings\ttotalIssues\tfilesWithIssues\tfileReadErrors）

$(cat /home/devuser/work/CodeX/booksB/tmp_unicode_scan_2026-02-04_after_merge.tsv)

[ootakazuhiko]

Unicode再スキャン結果（全書籍）※追記（TSVを埋め込み）

book-formatter: b38f6f1
node: v22.19.0

• 対象: existing-books.md に記載の28冊 + linux-infra-textbook2
• 実行: book-formatter/scripts/check-unicode.js（pattern: **/*.md, fail-on: none, node_modules は ignore）
• 結果: 全書籍で errors=0 / warnings=0 / fileReadErrors=0

TSV（repo errors warnings totalIssues filesWithIssues fileReadErrors）

repo	errors	warnings	totalIssues	filesWithIssues	fileReadErrors
illustrated-linux-basics-book	0	0	0	0	0
wsl2-linux-essentials-book	0	0	0	0	0
theoretical-computer-science-textbook	0	0	0	0	0
linux-infra-textbook	0	0	0	0	0
it-infra-software-essentials-book	0	0	0	0	0
IT-infra-book	0	0	0	0	0
podman-book	0	0	0	0	0
practical-auth-book	0	0	0	0	0
cloud-infra-book	0	0	0	0	0
IT-infra-troubleshooting-book	0	0	0	0	0
it-infra-security-guide-book	0	0	0	0	0
pentest-learning-book	0	0	0	0	0
proxmox_book	0	0	0	0	0
github-guide-for-beginners-book	0	0	0	0	0
github-workflow-book	0	0	0	0	0
ai-testing-strategy-book	0	0	0	0	0
formal-methods-book	0	0	0	0	0
small-webapp-software-design-book	0	0	0	0	0
supabase-architecture-patterns-book	0	0	0	0	0
BioinformaticsGuide-book	0	0	0	0	0
LogicalThinking-AI-Era-Guide	0	0	0	0	0
ai-era-engineers-mind-book	0	0	0	0	0
ai-communication-book	0	0	0	0	0
negotiation-for-engineers-book	0	0	0	0	0
IT-engineer-communication-book	0	0	0	0	0
cs-visionaries-book	0	0	0	0	0
computational-physicalism-book	0	0	0	0	0
ethereum-learning-bootcamp	0	0	0	0	0
linux-infra-textbook2	0	0	0	0	0

[ootakazuhiko]

進捗更新（Phase 1: リンク品質）

• check-links のハードニングPRを作成しました（ignore精度/Markdownパース/アンカー対応）
  • fix(qa): harden check-links (ignore/anchors) book-formatter#61

このPRが入ると、node_modules 等の依存物由来のノイズを排除しつつ、内部リンク/アンカーの検査精度を上げて全書籍へ横展開できます。

[ootakazuhiko]

進捗（リンク/アンカー）

• book-formatter: check-links 強化（ignore/anchors）+ templates/examples をデフォルト除外

  • fix(qa): harden check-links (ignore/anchors) book-formatter#61

• 書籍側（broken internal links 修正PR）

  • fix(docs): remove nonexistent links from chapter template ethereum-learning-bootcamp#72
  • fix(docs): resolve broken internal links IT-infra-book#100
  • fix(docs): repair integration checklist links practical-auth-book#94
  • fix(docs): repair broken reference link theoretical-computer-science-textbook#227
  • fix(docs): replace placeholder URL in markdown example github-guide-for-beginners-book#157
  • fix(docs): repair SOP internal link ai-era-engineers-mind-book#97
  • fix(docs): repair internal links in appendix ai-communication-book#97
  • fix(docs): repair integration checklist references LogicalThinking-AI-Era-Guide#86
  • fix(docs): resolve broken internal links computational-physicalism-book#98

補足:

• 内部リンク/アンカーの broken を対象（Fail）。外部リンクは warning（best-effort）の設計です。