理解度チェック
クイズの説明
Step 1で学んだドキュメントの基本について、理解度を確認します。
- 全8問
- 合格ライン: 80%（7問正解）
- 不合格の場合は復習してから再挑戦してください
問題
Q1. 技術ドキュメントが必要な理由として最も適切なものはどれですか？
- A) 会社の規則で決まっているから
- B) コードだけでは意図や背景が伝わらないから
- C) 開発者の作業時間を増やすため
- D) 見た目を良くするため
正解: B
コードには「何をしているか」は書かれていますが、「なぜそうしたのか」「どう使うのか」などはコードだけでは分かりません。ドキュメントはこれらを伝えるために必要です。
</details>Q2. 「議事録」の主な目的として正しいものはどれですか？
- A) 会議の参加者を評価すること
- B) 決定事項とアクションアイテムを記録し共有すること
- C) 会議の時間を記録すること
- D) 発言者の名前を全て記録すること
正解: B
議事録は「何が決まったか」「誰が何をするか」を記録し、参加者・不参加者に共有するためのものです。
</details>Q3. 「手順書」と「マニュアル」の違いとして正しいものはどれですか？
- A) 手順書は上級者向け、マニュアルは初心者向け
- B) 手順書は特定の作業の手順、マニュアルは製品全体の使い方
- C) 手順書は社内用、マニュアルは社外用
- D) 手順書とマニュアルは同じもの
正解: B
手順書は特定の作業を完了するための具体的な手順を記載します。マニュアルは製品やシステム全体の使い方を網羅的に説明するものです。
</details>Q4. Markdownで「見出しレベル2」 を作成する記法はどれですか？
- A) # 見出し
- B) ## 見出し
- C) ### 見出し
- D) 見出し
正解: B
Markdownでは # の数で見出しレベルが決まります。
#= H1（見出しレベル1）##= H2（見出しレベル2）###= H3（見出しレベル3）
Q5. Markdownでリンクを作成する正しい記法はどれですか？
- A) (リンクテキスト)[URL]
- B) リンクテキスト
- C) {リンクテキスト}(URL)
- D) <リンクテキスト>(URL)
正解: B
Markdownのリンクは [表示テキスト](URL) の形式で記述します。
例: [Google](https://www.google.com)
Q6. 技術文書における「5W1H」で、最も重要な要素はどれですか？
- A) When（いつ）
- B) Where（どこで）
- C) What（何を）とWhy（なぜ）
- D) Who（誰が）
正解: C
技術文書では「What（何をするか/したか）」と「Why（なぜそうするか/したか）」が最も重要です。これらが明確でないと、読み手は内容を正しく理解できません。
</details>Q7. ドキュメントを書くスキルが評価される理由として正しいものはどれですか？
- A) コードを書く時間が減るから
- B) 成果が文書として残り、引き継ぎがスムーズにできるから
- C) 会議に出なくてよくなるから
- D) プログラミングができなくても良いから
正解: B
ドキュメントが書けると、成果が形として残り、他の人への引き継ぎもスムーズになります。チームでの仕事の効率が大きく向上します。
</details>Q8. Markdownでコードブロックを作成する記法として正しいものはどれですか？
- A)
コード - B)
コード - C) {コード}
- D) [コード]
正解: B
複数行のコードブロックは ``` で囲みます。言語名を指定するとシンタックスハイライトも可能です。
```javascript
const x = 1;
なお、`コード` はインラインコード（1行内）の記法です。
</details>
---
## 結果
### 7問以上正解の場合
**合格です！おめでとうございます！**
Step 1「ドキュメントの基礎を学ぼう」を完了しました。
次はStep 2「議事録を作成しよう」に進みましょう。
### 6問以下の場合
**もう少し復習しましょう**
間違えた問題の内容を、該当するセクションで復習してください：
| 問題 | 復習セクション |
|------|---------------|
| Q1 | step1_1 なぜドキュメントを学ぶのか |
| Q2-Q3 | step1_2 技術文書の種類と用途 |
| Q4-Q5, Q8 | step1_3 Markdownの基本 |
| Q6-Q7 | step1_4 技術文書の基本用語 |
---
## Step 1 完了！
お疲れさまでした！
### 学んだこと
- ドキュメントが必要な理由
- 技術文書の種類（議事録、手順書、週報、障害報告書など）
- Markdownの基本記法
- 技術文書の基本用語と考え方
### 次のステップ
**Step 2: 議事録を作成しよう（4時間）**
会議の記録を正確に残す「議事録」の書き方を学びます。
---
*推定所要時間: 15分*