Immutable Document Model
immutable data modelを参考にしたドキュメンテーションの方法
フロー情報とストック情報
社内ドキュメントはなぜ更新されないのか?情報の鮮度を最小限の運用負荷で維持する「イミュータブルドキュメントモデル」のススメ - KAKEHASHI Tech Blog
大まかな内容としては、
ドキュメントする情報を3種類に分けて考える
ストック情報
リソース情報
status的なmutableな情報
それに関する最新の状態での情報
eventsをreduceしてできたもの
イベント情報
event的なimmutableな情報
変更に関する経緯というのはimmutableである
フロー情報
議事録、思考ログなどの一過性のもの
以下のような運用フローで書く
https://gyazo.com/c4617e076ca63caecdb27c2e04415539
要は、
議論中はイベント情報を書いて、
合意が取れたら、リソース情報を更新する
構造化されているのは良い
同じような運用を既にScrapboxでやっていたmrsekut.icon
ただ、そこまで厳密(?)に分類する必要があるのかどうかは疑問
もうちょい緩くやってもワークすると思う
議事録を取ったり、そもそもドキュメント上で会話するなら、それはイベント情報とフロー情報の区別は付かなくなる
リソース情報は常に更新されてるのが良いが、それはそれを必要だと思った人が書けば良い、とも言える
/shokai/フロー情報とストック情報という考えは間違い