開発SIerにおいて、システムをメンテナンスしていくのに必要なドキュメントとはなんだろう。bloghttp://d.hatena.ne.jp/higayasuo/20080721/1216607451仕様が固まった後に作成するドキュメントは、プログラムと一対一になるようなドキュメントではない。そんなのはプログラムを見ればすむ話だから。メンテナンスする人が必要になるドキュメントを書く。メンテナンスする人にとってはドキュメントは必要ですよ。全部ソース読めはきつい。対顧客としてこのシステムはなにをするためのものかがわからないと引き継ぎ困難です。『概要設計』と呼ばれるレベルのものでしょうか。・機能リストのようなもの・(他システムとの接続があれば)接続関係図があるとメンテナンスが容易になります。(どのシステムに影響があるかわからないと、事前の影響確認とかしてもらえない)そう考えると、対外的には・外部システムとの接続仕様(I/F仕様)は残しておく必要があるかな。外部システムの担当が他社であれば、接続仕様がないと話にならないかもしれません。Web画面で済むならこれも不要かも。・機能とソースの関連性を図示しておけば、いじったときの影響を判断することが可能。テスト年中まわしていれば気付くだろうしね。障害発生時の動きを示した文書は、エラーメッセージがしっかりしていれば不要。H/W障害発生時や停止したときの復旧方法など示した文書、再構築手順は必要か。コード仕様書などは、「1=会社員」とか「2=公務員」などという内容にしなければ不要そうだ。こちらのほうが直感的ではあるんだけど)現状、ホストのデータの持ちかたをひきずったシステムをどうすればいいのか...外部から飛んでくるデータもこんなんだしなぁ。10リンクはてなブログブログをはじめる週刊はてなブログはてなブログProはてなブログをはじめよう!ataukyさんは、はてなブログを使っています。ブログを報告する引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。