generated at
2/16/2025, 11:21:19 PM
実装には設計意図が残らない
だからコメントを書こう!ドキュメントを書こう!とかよく見る
はコメントには懐疑的
ドキュメントも銀の弾丸ではないし難しい
質問は貢献
で、だんだん洗練されていくものな気もする
テスト、ドキュメント(要件定義)、コードのうち2つが決まると最後の一つをAI生成できるみたいな話があった気がする?
コード=実装だけでは一意に決まらない、不足がある
大抵はプロダクトオーナー的な人の頭の中にドキュメント要素があって、その人が実装の良しあしを頑張って管理している
Scrapboxは第二の脳
なのでドキュメントの役割ができると思っている
アーキテクチャ図
が必要