校正: clone→PR の最小手順（CLI）と失敗回避を追記 (#209)

* docs: PR最小手順（CLI）を追記し長行を解消

* docs: generalize default branch in cli steps

Author: ootakazuhiko

docs/chapters/chapter-advanced-features/index.md

@@ -604,9 +604,10 @@ winget install --id GitHub.cli
 
 # Ubuntu/Debian
 curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
-echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] \\
-https://cli.github.com/packages stable main" | \\
-sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
+ARCH=$(dpkg --print-architecture)
+KEYRING=/usr/share/keyrings/githubcli-archive-keyring.gpg
+echo "deb [arch=${ARCH} signed-by=${KEYRING}] https://cli.github.com/packages stable main" | \
+  sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
 sudo apt update
 sudo apt install gh
 

docs/chapters/chapter-branch-operations/index.md

@@ -188,6 +188,62 @@ Pull Requestには様々な種類があります。新機能追加、バグ修
 
 Pull Requestの作成からマージまでの一連の流れを理解し、効率的なチーム開発を実現しましょう。
 
+### 最小手順（CLI）：clone → branch → commit → push → PR
+GitHub Desktop ではなくターミナルで作業する場合でも、流れは同じです。ここでは最小手順だけをまとめます。
+
+前提:
+- Git がインストール済み
+- リモートは `origin`、統合先は `<default-branch>`（例: `main`。プロジェクトにより異なるため要確認）
+- PR 作成はブラウザ、または GitHub CLI（`gh`）を利用（任意）
+
+1) リポジトリを clone して移動します。
+
+```bash
+git clone https://github.com/<owner>/<repo>.git
+cd <repo>
+```
+
+2) 最新の既定ブランチ（ここでは `<default-branch>`）を取得し、作業用ブランチを作成します。
+
+```bash
+git switch <default-branch>
+git pull --ff-only
+git switch -c feat/<topic>
+# 参考: 古い Git の場合
+# git checkout -b feat/<topic>
+```
+
+3) 変更をステージし、コミットします（不要なファイルを混ぜない）。
+
+```bash
+git status
+git add <file1> <file2>
+# 参考: 変更範囲を確認しながらステージする場合
+# git add -p
+git commit -m "docs: update ..."
+```
+
+4) リモートへ push します。
+
+```bash
+git push -u origin feat/<topic>
+```
+
+5) Pull Request を作成します。
+
+- ブラウザ: GitHub 上で `feat/<topic>` から `<default-branch>` への PR を作成する
+- GitHub CLI（任意）:
+
+```bash
+gh pr create --base <default-branch> --head feat/<topic> --title "..." --body "..."
+```
+
+### よくある失敗と回避（最小）
+- `main` のまま作業してしまう: `git branch --show-current` でブランチ名を確認してから編集する
+- 意図しないファイルまでコミットする: `git status` で差分を確認し、`git add <file>` または `git add -p` を使う
+- `git push` で upstream エラーになる: 初回は `git push -u origin <branch>` を使う
+- PR が肥大化する: 目的を 1 つに絞り、無関係な整形やリファクタを混ぜない
+
 ### 作業用ブランチの削除
 
 マージが完了したら、不要になった作業用ブランチを削除できます：

manuscript/chapter-advanced-features/index.md

@@ -604,9 +604,10 @@ winget install --id GitHub.cli
 
 # Ubuntu/Debian
 curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
-echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] \\
-https://cli.github.com/packages stable main" | \\
-sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
+ARCH=$(dpkg --print-architecture)
+KEYRING=/usr/share/keyrings/githubcli-archive-keyring.gpg
+echo "deb [arch=${ARCH} signed-by=${KEYRING}] https://cli.github.com/packages stable main" | \
+  sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
 sudo apt update
 sudo apt install gh
 

manuscript/chapter-branch-operations/index.md

@@ -188,6 +188,62 @@ Pull Requestには様々な種類があります。新機能追加、バグ修
 
 Pull Requestの作成からマージまでの一連の流れを理解し、効率的なチーム開発を実現しましょう。
 
+### 最小手順（CLI）：clone → branch → commit → push → PR
+GitHub Desktop ではなくターミナルで作業する場合でも、流れは同じです。ここでは最小手順だけをまとめます。
+
+前提:
+- Git がインストール済み
+- リモートは `origin`、統合先は `<default-branch>`（例: `main`。プロジェクトにより異なるため要確認）
+- PR 作成はブラウザ、または GitHub CLI（`gh`）を利用（任意）
+
+1) リポジトリを clone して移動します。
+
+```bash
+git clone https://github.com/<owner>/<repo>.git
+cd <repo>
+```
+
+2) 最新の既定ブランチ（ここでは `<default-branch>`）を取得し、作業用ブランチを作成します。
+
+```bash
+git switch <default-branch>
+git pull --ff-only
+git switch -c feat/<topic>
+# 参考: 古い Git の場合
+# git checkout -b feat/<topic>
+```
+
+3) 変更をステージし、コミットします（不要なファイルを混ぜない）。
+
+```bash
+git status
+git add <file1> <file2>
+# 参考: 変更範囲を確認しながらステージする場合
+# git add -p
+git commit -m "docs: update ..."
+```
+
+4) リモートへ push します。
+
+```bash
+git push -u origin feat/<topic>
+```
+
+5) Pull Request を作成します。
+
+- ブラウザ: GitHub 上で `feat/<topic>` から `<default-branch>` への PR を作成する
+- GitHub CLI（任意）:
+
+```bash
+gh pr create --base <default-branch> --head feat/<topic> --title "..." --body "..."
+```
+
+### よくある失敗と回避（最小）
+- `main` のまま作業してしまう: `git branch --show-current` でブランチ名を確認してから編集する
+- 意図しないファイルまでコミットする: `git status` で差分を確認し、`git add <file>` または `git add -p` を使う
+- `git push` で upstream エラーになる: 初回は `git push -u origin <branch>` を使う
+- PR が肥大化する: 目的を 1 つに絞り、無関係な整形やリファクタを混ぜない
+
 ### 作業用ブランチの削除
 
 マージが完了したら、不要になった作業用ブランチを削除できます：