翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
よくある質問
ADR プロセスを作成するメリットは何ですか?
プロジェクトチームは ADR プロセスを作成して、アーキテクチャに関する意思決定を効率化し、同じアーキテクチャのトピックについての繰り返しの議論を回避し、アーキテクチャに関する決定を効果的に伝達すべきです。
プロジェクトチームはいつ ADR を作成する必要がありますか?
プロジェクトチームは、構造 (マイクロサービスなどのパターン)、機能以外の要件 (セキュリティ、高可用性、耐障害性)、依存関係 (コンポーネントの結合)、インターフェイス (API と公開済みの契約)、建設技術 (ライブラリ、フレームワーク、ツール、プロセス) に影響するソフトウェアのあらゆる側面について ADR を作成する必要があります。
プロジェクトチームはどのくらいの頻度で ADR をレビューすべきですか?
プロジェクトチームは ADR を受け入れる前に少なくとも 1 回はレビューする必要があります。
ADR を作成するのは誰ですか?
すべてのチームメンバーが ADR を作成できます。ADR の所有権の概念を広めることをお勧めします。ADR を所有する作成者は、ADR の内容を積極的に管理し、伝える必要があります。他のチームメンバーはいつでも ADR に寄稿できます。ADR の所有者は ADR への変更を承認する必要があります。
ADR にはどのような情報を含める必要がありますか?
少なくとも、各 ADR は、決定の背景、決定自体、決定がプロジェクトとその成果物に及ぼす影響について定義する必要があります。コンテキストには、チームが検討した可能な解決策を記載する必要があります。また、プロジェクト、顧客、または技術スタックに関連する情報も含める必要があります。決定には、チームが採用することを決定したソリューションを強制的な型で明確に記載する必要があります。「すべき」などの言葉は使わず、各決定を「私たちは...を使用します」または「チームは...を使用する必要があります」と表現します。結果のセクションでは、決定を下す際の既知のトレードオフをすべて記載する必要があります。各 ADR には、ステータスと、変更日と変更の責任者を記載した変更ログが必要です。
ADR テンプレートはどこにありますか?
ADR テンプレートには複数のバージョンとバリエーションがあります。一般的に使用される ADR テンプレートの公開コレクションについては、ADR GitHub リポジトリ
