ドキュメント管理(ADR)とは?自分ごと体験で覚えるITパスポート対策
🎬 こんなシーン、想像してみて
開発チームの自分。「半年前PostgreSQL採用したが誰も理由覚えてない・議事録もなし」。READMEに追記?
❓ 2問問題:あなたならどっち?
次の状況に当てはまるのは?
- ✅ ADR(Architecture Decision Record:アーキテクチャ決定記録)を作成し、「何を・なぜ・どんな選択肢を検討して決めたか」を記録しておく
- ❌ README.mdに技術スタックの一覧を追記する→ READMEは概要のみ。「意思決定の文脈・代替案・根拠」を残すのがADR
✅ 正解:ADR(Architecture Decision Record:アーキテクチャ決定記録)を作成し、「何を・なぜ・どんな選択肢を検討して決めたか」を記録しておく
📘 ドキュメント管理(ADR)とは何か
ADR=アーキテクチャ上の意思決定の記録文書ADR(Architecture Decision Record)はアーキテクチャ上の重要な意思決定を「状況・決定内容・根拠・代替案・結果」の形式で残す短いドキュメント。コードリポジトリと一緒に管理するのが一般的。
🎯 試験のキモ
試験では「ADR=設計意思決定の透明性確保」として問われる。新メンバーのオンボーディング・将来の意思決定見直しに有効。テクニカルドキュメントの一形態として技術的負債管理と関連する。 **覚え方** 🎯 ADR=**Architecture Decision Record=設計決定の議事録**。**状況・決定・根拠・代替案・結果**の5項目。
⚠️ 間違いやすいポイント
【ひっかけ】ADRはREADMEや議事録ではなく「設計意思決定専用の記録文書」。構成要素は状況・決定内容・根拠・代替案・結果の5項目。コードリポジトリと一緒に管理するのが特徴。試験では「何を記録するか」と「どこに保管するか」の組み合わせ問題で誤選択肢が提示される。
🧠 覚え方
ADR=**Architecture Decision Record=設計決定の議事録**。**状況・決定・根拠・代替案・結果**の5項目。
📚 ITパスポートの試験対策・勉強方法
ドキュメント管理(ADR)はITパスポートのIT全般分野で頻出(mid)。ITパスポート 過去問・勉強方法・独学・何時間に取り組むなら、自分ごとシナリオで一度体験してから問題を解くのが定着の鍵。何度も繰り返して覚え方フレーズを口に出すと記憶に残りやすい。
知識をクイズで確認しよう!
🏆 用語4択チャレンジ →