ずん

なんかアーキテクチャ決定レコードって話題になってるのだ。はかせ、これって何なのだ？

でぇじょうぶ博士

ADRは、技術的な選択を記録するドキュメントでやんす。Google Cloudでの設計決定を明確にするためのものです。

やきう

ほーん、つまり「俺たちがこうした理由」みたいな言い訳帳やな。

ずん

言い訳帳...？でも、それって役に立つのか？

でぇじょうぶ博士

やんす。問題発生時のトラブルシューティングや将来の意思決定に役立つでやんすよ。

やきう

ワイもADR書いて、「今日は寝坊したから遅刻しました」って上司に見せたろかな。

ずん

それただの日記なのだ。でも、どうしてMarkdown形式が多いのだ？

でぇじょうぶ博士

Markdownは軽量でテキストベースだから、迅速な更新とアクセスが可能なんでやんす。

やきう

軽量言うてもワイの体重には勝てへんな！

ずん

やきうさん、それ自慢にならないっすよ。でも、ADRってどこに保存するべきなのだ？

でぇじょうぶ博士

ソース管理リポジトリ内が理想的だけど、Wikiなど別メディアでも共有可能でやんすね。

ずん

なるほど！じゃあ僕も自分の日常をADRとして記録してみようかな。朝起きた理由とか...いや、それただの日記なのだ！