linux-infra-textbook Stage2/Stage3 対応（Round5）

[ootakazuhiko]

目的

• linux-infra-textbook を、シリーズ定義の Stage2（構成レビュー完了）〜Stage3（表現・スタイル）に引き上げる。
• Stage2/Stage3 の作業手順を、他書籍へ水平展開できる粒度で残す。

対象

• https://github.com/itdojp/linux-infra-textbook （PRIVATE）

作業範囲

Stage2（構成レビュー / マクロ編集）

1. 構成把握とレビュー文書作成（PR）

   • 参照ファイル例: index.md/README.md/preface.md、SUMMARY.md、docs/chapters/*.md（実構成に合わせる）
   • 出力先: docs/project-management/structure-review-round1.md
   • 内容:
     • 書籍の概要（想定読者 / ゴール）
     • 現状の章構成サマリ（章タイトル / 狙い / 学習目標（あれば））
     • 構成上の気になる点（重複、順序、密度、導入→本論→まとめの欠落など）
     • 構成改善の提案（案）

2. 必要に応じた構成変更（別PR）

   • 章/節の統合・分割、順序調整、章末まとめ整備など（採否は人間判断）

Stage3（表現・スタイル / ミクロ編集）

• 「1章=1PR」を基本に小粒度で実施。
• 意味・手順・主張は変更しない。
• 文体・表記ゆれ（です/ます、句読点、箇条書き導入の表記など）を中心に調整。

運用

• PR本文/Issueコメントは gh ... --body-file を使用（エスケープ文字の表示回避）。
• 追加作業を実施した場合は、本Issueに逐次コメントで追記する。

Done の定義

• Stage2: docs/project-management/structure-review-round1.md が作成され、必要な構成変更がマージされている
• Stage3: 章単位の小PRで表現・スタイル調整が完了し、主要な表記ゆれが解消されている
• project-management/content-improvement.md の該当行が更新されている

[ootakazuhiko]

着手しました（Stage2 構成レビュー）。

• レビュー文書追加PR: https://github.com/itdojp/linux-infra-textbook/pull/71
  • 追加ファイル: docs/project-management/structure-review-round1.md

[ootakazuhiko]

Stage2（構成変更）として、レビュー指摘のうち機械的に整合できる範囲を別PRで対応しました。

• 構成変更PR（節番号・まとめ位置・ナビ表示名）: https://github.com/itdojp/linux-infra-textbook/pull/72

[ootakazuhiko]

要確認（太田さん判断が必要そうな点）

• 付録A（docs/appendices/appendix-a/index.md）を読者導線（docs/_data/navigation.yml）に残しますか？
  • 本編（Linuxインフラ）と目的が異なる「テンプレ設定リファレンス」なので、初学者の迷子防止の観点では「ナビから除外」も選択肢です。
• リポジトリ入口（README.md）を「書籍案内」に寄せますか？
  • 現状はテンプレ説明のため、書籍の読み始め（docs/index.md）への導線が弱い状態です。

方針が決まれば、Stage2 の残タスクとして別PRで反映します。

[ootakazuhiko]

Stage3（表現・スタイル）をパイロット開始しました。

• 第1章PR: https://github.com/itdojp/linux-infra-textbook/pull/73

[ootakazuhiko]

Stage3（表現・スタイル）パイロット（第2章）です。

• 第2章PR: https://github.com/itdojp/linux-infra-textbook/pull/74

[ootakazuhiko]

方針決定（付録A削除、READMEを読者入口に）を反映するPRを作成しました。

• PR: https://github.com/itdojp/linux-infra-textbook/pull/75
  • 付録A（テンプレ設定リファレンス）削除
  • README.md を読者・学習者の入口として刷新
  • docs/_data/navigation.yml から付録Aを除外

補足: public化を検討する場合は、秘匿情報が現行/履歴に含まれていないかの確認が必要です（要確認）。

[ootakazuhiko]

進捗表更新PRを作成しました。

• docs: update linux-infra-textbook progress #77
  • linux-infra-textbook: Stage2=完了（Issue #67: Stage3参照PRリンクを更新 #71/Issue #67: Stage3完了の反映 #72）、Stage3=進行中（linux-infra-textbook2 Stage2/Stage3 対応（Round4） #73/Issue #73: 進捗表へlinux-infra-textbook2を追加 #74）、参照に linux-infra-textbook Stage2/Stage3 対応（Round5） #75 を追加

[ootakazuhiko]

linux-infra-textbook の Stage3（表現・スタイル）を、残りの章について「1章=1PR」で作成しました（各PRは該当章の Markdown 1ファイルのみ変更）。

• 第3章: https://github.com/itdojp/linux-infra-textbook/pull/76
• 第4章: https://github.com/itdojp/linux-infra-textbook/pull/77
• 第5章: https://github.com/itdojp/linux-infra-textbook/pull/78
• 第6章: https://github.com/itdojp/linux-infra-textbook/pull/79
• 第7章: https://github.com/itdojp/linux-infra-textbook/pull/80
• 第8章: https://github.com/itdojp/linux-infra-textbook/pull/81
• 第9章: https://github.com/itdojp/linux-infra-textbook/pull/82
• 第10章: https://github.com/itdojp/linux-infra-textbook/pull/83
• 第11章: https://github.com/itdojp/linux-infra-textbook/pull/84
• 第12章: https://github.com/itdojp/linux-infra-textbook/pull/85
• 第13章: https://github.com/itdojp/linux-infra-textbook/pull/86
• 第14章: https://github.com/itdojp/linux-infra-textbook/pull/87
• 第15章: https://github.com/itdojp/linux-infra-textbook/pull/88