理解度チェック：技術文書の種類を知ろう

クイズの説明

Step 1で学んだ内容の理解度をチェックします。

• 全10問
• 合格ライン: 80%（8問正解）
• 不合格の場合は復習してから再挑戦してください

問題

Q1. エンジニアがドキュメントを書く最も大きな理由はどれですか？

• A) 上司に言われたから
• B) コードだけでは意図や経緯が伝わらないから
• C) ファイルの容量を増やすため
• D) プログラミングの練習になるから

正解: B

コードには「何をしているか」は書かれていますが、「なぜそうしたのか」「どう使うのか」はドキュメントで伝える必要があります。

Q2. 会議で決まったことを記録する文書は何ですか？

• A) 週報
• B) 設計書
• C) 議事録
• D) README

正解: C

議事録は会議の決定事項、アクションアイテム、議論の内容を記録する文書です。

Q3. 「誰がやっても同じ結果になるように」手順を記録する文書はどれですか？

• A) 議事録
• B) 手順書
• C) 障害報告書
• D) 週報

正解: B

手順書は、作業の手順を順番に記録し、誰が実行しても同じ結果が得られることを目的とした文書です。

Q4. Markdownで「見出し」を作るために使う記号はどれですか？

• A) *
• B) #
• C) -
• D) >

正解: B

# の数で見出しのレベルを表します。# が見出し1、## が見出し2、### が見出し3です。

Q5. Markdownで太字にするための記法はどれですか？

• A) __テキスト__
• B) # テキスト
• C) **テキスト**
• D) > テキスト

正解: C

**テキスト** で太字になります。なお __テキスト__ も太字になりますが、一般的には ** が使われます。

Q6. Markdownでテーブル（表）のヘッダーと本体を区切るのに使うものはどれですか？

• A) ===
• B) ---
• C) ***
• D) ___

正解: B

テーブルでは |------|------| のように --- でヘッダー行と本体行を区切ります。

Q7. 「テンプレート」の説明として正しいものはどれですか？

• A) ファイルの拡張子のこと
• B) 文書のひな形のこと
• C) プログラミング言語の一種
• D) 文書を暗号化する仕組み

正解: B

テンプレートは文書のひな形です。あらかじめ構成が決まっていて、内容を埋めるだけで文書が完成します。

Q8. 「フォーマット」が持つ2つの意味として正しい組み合わせはどれですか？

• A) ファイル形式と書式
• B) 圧縮方法と暗号化方法
• C) プログラム言語とフレームワーク
• D) ハードウェアとソフトウェア

正解: A

フォーマットには「ファイル形式（.md, .docx, .pdf）」と「書式・体裁（見出しの使い方、日付の表記）」の2つの意味があります。

Q9. 障害報告書に含めるべき内容として適切でないものはどれですか？

• A) 発生日時と影響範囲
• B) 原因と対応内容
• C) 担当者の個人的な反省文
• D) 再発防止策

正解: C

障害報告書は客観的な事実を記録するものです。「発生日時」「影響範囲」「原因」「対応」「再発防止策」が必須項目であり、個人的な反省文は含めません。

Q10. ドキュメントのバージョン管理として推奨される方法はどれですか？

• A) ファイル名に「_最終版」を付ける
• B) Gitで変更履歴を管理する
• C) 日付ごとにフォルダを分ける
• D) メールで最新版を共有する

正解: B

Gitで管理すれば、常に最新版が1つで、過去の変更履歴もすべて追跡できます。ファイル名に「_最終版」を付ける方法は混乱の原因になります。

結果

8問以上正解の場合

合格です！おめでとうございます！

Step 1「技術文書の種類を知ろう」を完了しました。 次はStep 2「議事録を書いてみよう」に進みましょう。

7問以下の場合

もう少し復習しましょう

間違えた問題の内容を、該当するセクションで復習してください：

Step 1 完了！

お疲れさまでした！

学んだこと

• ドキュメントが必要な理由
• 技術文書の種類と用途
• Markdownの基本記法
• ドキュメントに関する基本用語

次のステップ

Step 2: 議事録を書いてみよう（4時間）

実際に議事録のテンプレートを使って、議事録を作成する練習をします。

推定所要時間: 15分