スナップショットとしてのドキュメント
ドキュメントはすぐ腐る、どうにか保持しないといけないみたいな問題意識はよく見る オンボーディング用のドキュメントとかはたしかにそう
腐っていると辛い
でも、全部が全部保持しないといけないドキュメントではないと思うlemonadern.icon
機能が実装されるとして、その時点での文脈や経緯をまとめているドキュメントはとても助かる
当時の状況を書いておくだけで役に立つのに、メンテナンスのコストを考慮して書かれない文書は多いのでは？
書いたら触らない、というドキュメントがあっていい
→スナップショットとしてのドキュメント
ドキュメントは更新されていないものと割り切る文化もセットで必要
関連