ADRはじめました - エス・エム・エス エンジニア テックブログ
こんにちは！夏ですね。@kimukei です。 今回は、弊プロジェクトのカイポケリニューアルで ADR を導入しましたというお話です。 ADRとは、「Architecture Decision Record」または、「Architectural Decision Records」の略でアーキテクチャ上で重要な決定を記録するドキュメントです。 詳しくは「DOCUMENTING ARCHITECTURE DECISIONS」 や「Architectural Decision Records」をご覧ください。 また ADR については、以前弊社の酒井が登壇したイベントでも触れられておりますので、こちらの記事もあわせて読んでみてください。 tech.bm-sms.co.jp ADR を導入しましたってエントリは巷には溢れかえっているので、今回はちょっと趣向を変えて実際に私たちが運用している ADR
ADRを運用している話 - サーバーワークスエンジニアブログ
はじめに 前提 ADRとは？ - 意思決定とその記録 Design Docsとの差分 Design Docsとは？ 経緯 FYI いつ書く？ ADR運用の前提条件 ステークホルダー コスト要件 導入対象の要件 確認・調査工数 フォーマット 意識していること 言語化とすり合わせ ？やTBD、会話の引用を活用する ドキュメントの読み手を意識する メリットとデメリット メリット 基本設計書や概念ドキュメントのベースとなる 後々の変更や運用において安全で迅速な対応が可能 デメリット とにかく時間がかかる なくてはならないもの？ ADR Design Docs 注意点 万能ではない 方針迷子に注意 プロジェクトに根付かせるポイント フォーマットを決める 書き手の意識 ステークホルダーへメリットを実感してもらう このブログもADRを根付かせる活動 最後に はじめに 本ブログでは、私が運用しているArc
大規模クラウドインフラ設計・構築案件の歩き方(AWS-28)がインフラエンジニアに刺さりまくりな内容だった | iret.media
AWS Summit Japan 2024 Day1の「大規模クラウドインフラ設計・構築案件の歩き方」のセッションについてレポートです。 控えめに言っても満足度の高いセッションでした。 大規模なクラウドインフラの設計構築運用に関わる方なら首がもげるくらい頷きが多い内容であり、アーカイブが公開された際はもう一度見たいと思うほど…。 セッションの内容には「設計書の一覧サンプル」や、「アプリ/インフラチームの責任分界」といった界隈でも関心が高い内容に触れられています。 考え方のひとつとして参考にしていきたい内容がモリモリでしたので、シェアさせていただきます。 セッション概要 大規模クラウドインフラ設計・構築案件の歩き方 Level 300: 中級者向け スピーカー: アマゾン ウェブ サービス ジャパン合同会社 仲谷 岳志 様 クラウド技術のコモディティ化により、エンタープライズ分野では近年、A
NECソリューションイノベータが挑む「アーキテクチャディシジョンレコード（ADR）」導入と製品開発チームの歩み - TECH PLAY Magazine
効率的な技術的負債の解消などを目的に、アーキテクチャの設計思想や変更履歴などをドキュメントとして残しておく技術手法が注目されている。NECソリューションイノベータで生体認証の基盤開発を担うチームでは、「アーキテクチャディシジョンレコード（ADR）」という技術を使い、同取り組みを行った。その導入の背景や流れ、成果などを紹介する。 アーキテクチャの決定に必要なのは、設計思想、選択・判断した理由 NECソリューションイノベータ株式会社 プラットフォーム事業ライン 第二ＰＦソフトウェア事業部 シニアプロフェッショナル 中島 剛氏 NECグループのシステムインテグレーターとして、各種システムの構築やITサービスの開発・提供を手掛けるNECソリューションイノベータ。今回登壇した中島剛氏は、同社のシニアプロフェッショナルとして、NECの強みである生体認証の基盤開発に従事している。 生体認証基盤の開発にお
Developers Summit 2023 SummerでADRについて発表しました & ベストスピーカー賞を受賞しました🎉 - スタディサプリ Product Team Blog
こんにちは。スタディサプリでプロダクトプラットフォームの開発を行っている @highwide です。 少し前の話になってしまいますが、2023-07-27に行われた「Developers Summit 2023 Summer」(以下、「デブサミ」と書きます)にて「アーキテクチャデシジョンレコード」(ADR)についての発表をしましたので、その報告をさせていただきます。 「日々の意思決定の積み重ねを記録するアーキテクチャ・デシジョン・レコード」というタイトルで発表しました。 発表資料はこちらです。 また、デブサミのサイトでは、発表の当日の録画が見られるようです。 途中、自分の声に反応してしまったApple Watchに焦る様子なども見られるかと思います...(恥ずかしい...) codezine.jp ベストスピーカー賞受賞 🎉 また、この度、本カンファレンスにおけるベストスピーカー賞(1位
Using architectural decision records to streamline technical decision-making for a software development project - AWS Prescriptive Guidance
Using architectural decision records to streamline technical decision-making for a software development project Darius Kunce and Dominik Goby, Amazon Web Services (AWS) March 2022 (document history) This guide introduces the architectural decision records (ADR) process for software engineering projects. ADRs support team alignment, document strategic directions for a project or product, and reduce
Architectural Decision Records | adr.github.io
Architectural Decision Records (ADRs) An Architectural Decision (AD) is a justified design choice that addresses a functional or non-functional requirement that is architecturally significant. An Architecturally Significant Requirement (ASR) is a requirement that has a measurable effect on the architecture and quality of a software and/or hardware system. An Architectural Decision Record (ADR) cap
〜その意思決定を刻め〜「アーキテクチャ・デシジョン・レコード(ADR)」を利用した設計の記録 - スタディサプリ Product Team Blog
こんにちは。スタディサプリのWeb開発をやっている@highwideです。 今日は、自分の所属する"コーチングチーム"(個別指導コースや合格特訓コースの機能開発を行っています)が、最近のプロジェクトで利用した「アーキテクチャ・デシジョン・レコード」、通称「ADR」について紹介したいと思います。 アーキテクチャ・デシジョン・レコード(ADR)とは 「ADR」「アーキテクチャ・デシジョン・レコード」という概念を知ったのは、社内で行っていた「Design It! プログラマーのためのアーキテクティング入門」(以後「Design It!」)の読書会でのことでした。 www.oreilly.co.jp 最初にそのキーワードが登場する「11.2.3 必要なときだけ形式的な記述に投資する」では、「"膨大な量のドキュメントになる傾向"がある形式的なドキュメンテーション」に対比して、以下のように紹介されます
ADR(Architecture Decision Records)を書く
アーキテクチャの検討を記録するADR(Architectural Decision Records)の方式で、自身がADRを採用するか検討した。 ステータス: 承認 決定者: @niku 日付: 2020-05-19 文脈と問題点の説明 ソフトウェア開発中に、あるアーキテクチャを採用した理由を知りたいことがある。 幸運にもそのアーキテクチャを採用した開発者にインタビュー可能で、また開発者の記憶が定かであれば、当時どのような状況・どのような選択肢が用意されている中から選択したかを明らかにできる。 しかしそうではなかった場合、過去に採用したアーキテクチャを盲目的に受けいれたり、完全に無視するといった不健全な意思決定を強いられることになる。 そこで、決定の粒度が大きくかつプロダクトの品質に大きく影響を与えるアーキテクチャ上の変更の「なぜ」を記録し、時間が経過した後も簡単にアクセスできるよう AD
アーキテクチャに関するドキュメントの残しかた - ADRとARCHITECTURE.md テンプレート - Qiita
技術、アーキテクチャ設計の指針には 技術選定/アーキテクチャ設計で後悔しないためのガイドライン という資料があるが、ここでもアーキテクチャディシジョンレコードをつける という文書に触れられている。「なんでこのアーキテクチャにしたの？」は、プロジェクト外の者、あるいはもちろん、プロジェクトに新規参加する者にとって大事な資料となる。 以下具体的に ADR と、ARCHITECTURE.md というものに絞って何を書くべきか書いた。 1. ADR - Architecture Decision Record アーキテクチャ決定録 目的: アーキテクチャに関わるドキュメント決定記録。 あれ、これ以前どう決めましたっけ？ の決定録。意思決定の記録を残す - ADRの話 に以下がまとめられている。 書き方ポイント フォーマット タイトル (Title) ステータス (Status) 文脈、背景 (Co
Documenting Architecture Decisions
Context Architecture for agile projects has to be described and defined differently. Not all decisions will be made at once, nor will all of them be done when the project begins. Agile methods are not opposed to documentation, only to valueless documentation. Documents that assist the team itself can have value, but only if they are kept up to date. Large documents are never kept up to date. Small
アーキテクチャの「なぜ？」を記録する！ADRってなんぞや？ - Qiita
5月のThoughtWorksのTechnology RadarでもADOPTされたADRという手法について、面白かったので、ざっくり自分なりに調べたメモです。 Technology Radarでは以下のように述べられています。 多くのドキュメントは、読みやすいコードとテストに置き換えることができます。しかし、進化的アーキテクチャでは、将来のチームメンバーの利益と外部の監督のために、特定の設計上の決定を記録することが重要です。Lightweight Architecture Decision Recordsは、重要なアーキテクチャー決定を、そのコンテキストおよび結果と共に取り込むための技法です。これらの詳細は、WikiやWebサイトではなくソース管理に格納することをお勧めします。そうすれば、コードと同期したままのレコードを提供できるからです。ほとんどのプロジェクトでは、この手法を使いたくな
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - joelparkerhenderson/architecture-decision-record: Architecture decision record (ADR) examples for software planning, IT leadership, and template documentation
AWSがアーキテクチャ決定レコードのガイドを公開