君のプロジェクトにデータシートはあるか：101回死んだエンジニア：エンジニアライフ

いろいろな仕事を渡り歩き、今はインフラ系エンジニアをやっている。いろんな業種からの視点も交えてコラムを綴らせていただきます。 ■内部向けドキュメントが抜けている どんなプロジェクトでも、必要なドキュメントってあると思う。いろいろなプロジェクトに携わってきたけど、どこにも共通して言えることがある。 内部向けのドキュメントが貧弱である。 お客様に提出するドキュメントはきちんとレビューまでするが、内部向け資料は、ドキュメントどころか一子相伝の口頭伝授だったりすることも多い。なんだ、この差は？ やりづらくて仕方ない。 ■何を見てドキュメントを書くか ここで1つ、疑問に思うことがある。外部向けのドキュメントだが、いったい何を見てつくっているんだ？ ということだ。最近のサーバ製品や、レポート作成ツールは優秀だ。このツールを起動して、パラメータを手書きでExcelに貼り付けているのをよく見るが……。 ち

[s_hiiragi]

“ExcelやWordを使ってドキュメントを作成する時には、2つの要素がある。“内容”と“体裁”だ。実は、この2つは別々に管理する必要がある。 　“内容”の部分だが、必ずドキュメントのファイルとは別に管理する必要…"