情シス現場でよく問題になるものシリーズ。
ドキュメントの管理は悩ましい問題です。
設計書や仕様書をどこまで細かく書くべきか。
細かいほど正確性は上がるでしょうが、
書くのにかなりの手間暇コストがかかりますし、
それを常に最新化するための維持も大変です。
できるだけ不要なものを省いて必要最低限に絞り
かつ更新がしやすくなるように工夫したいものです。
中途半端なものを作ってしまったり
更新がしにくく最新化されていないと
ドキュメントの情報が誤ってしまい
事故の元になってしまいます。
どの情報をどう残しておくべきなのか
組織としてルールを作ることを勧めます。