InfoQ ホームページ Architecture Documentation に関するすべてのコンテンツ
アーティクル
RSSフィード-
/articles/continuous-documentation/ja/smallimage/SWIMM-s-1622628522688.jpg)
継続的ドキュメンテーション - コード知識共有への新たなアプローチ
ドキュメントは開発の重要な部分です。しかし、コードが変更されれば、ドキュメントはすぐに陳腐化してしまいます。継続的ドキュメンテーションでは、継続的に検証する、最も必要な時に作成する、コードに結合する、という3つの原則を重視します。
-
/articles/why-architectural-diagrams/ja/smallimage/why-architectural-diagrams-s-1547639074677.jpeg)
なぜアーキテクチャ図を必要とするのか？
ソフトウェアアーキテクチャ図は、うまく作ると、開発チーム内および外部ステークホルダーとのコミュニケーションを大幅に改善させることができる。それには、対象読者を理解することと、含めるべきものを慎重に自制することが必要だ。ひどい図がたくさんあったというだけで、図なんて必要ない、役に立たないと考えないようにしよう。
-
/articles/C4-architecture-model/ja/smallimage/Icon_sm-1529798065695-1535426901703.jpg)
ソフトウェアアーキテクチャのためのC4モデル
ソフトウェアアーキテクチャ図は非常に便利なコミュニケーションツールではありますが、多くのチームが図を作成することを縮小しています。また、図を作成したとしても、しばしば混乱と不明瞭さを抱えています。C4モデルは、コンテキスト、コンテナ、コンポーネント、コードといった一連の階層的なソフトウェアアーキテクチャ図で構成されています。