2008-08-07(Thu) [長年日記]
_ 文書作成標準
ビジネス文書や開発ドキュメントを作成するにあたっての標準化にあたって考えるべき事。
- 標準化する目的を明確にする。
- 目的に沿ってルール、推奨、指標を明記した文書を作成する。
- 同文書の内容について関係者全員のコンセンサスを得る。
- 同文書を公布する。
- 定期的に見直しを行う。
ここまでで標準化のプロセスが完了。標準化プロセスについては本一冊を費やす内容だと思うのでそれらを参照する。
より具体的な話。例として次のようなルール、推奨、指標を作る。
- 原則として文書作成はWORD、表等はEXCELを用いて作成する。
- 共通事項
- 印刷されることを意識する。印刷確認を行う。
- 文書は表紙と目次と履歴と内容から成る。
- ヘッダ、フッタにそれぞれファイル名、更新日時、ページ番号をつける。ある一ページを抜き出して、それがどのファイルのどのバージョンのどのページであるか判断できる。
- 見出し、図、表にはそれぞれ見出し番号、図番号、表番号をつける。
- 表には見出しと項番をつける。
- 表紙は文書名、作成日時、作成者から成る。
- 履歴は更新日時、更新箇所、更新内容、更新理由、更新者から成る。
- WORD
- 構造化文書となるよう意識する。
- スタイルを用いる。
- EXCEL
- 印刷した際、セルが途切れないように意識する。
WORD、EXCELそれぞれに基準となるファイルがあると親切だろう。
標準化団体等が策定している規則や、論文の規則等、一般的なビジネス文書の書き方等を流用して自分用にカスタマイズする方が自分で作るより標準的で簡単。
このくらいならビジネスマナーレベルなので、開発文書であればそれ特有の規則を別途設ける必要があるだろう。
思いついたら追記修正する。
参考
_ 文書の目的
たいていの文書の最大の目的は「伝えること」である。
加えて以下のような条件がつく
- 正しく伝わること
- そのために曖昧な表現を避けること
- 過不足無く伝わること
- 多すぎても少なすぎてもいけない
バランス感覚とセンスと経験が問われるが、それらは個人に依存するため、標準を明記した文書が必要となる。
[ツッコミを入れる]
ツッコミ・コメントがあればどうぞ! E-mailアドレスは公開されません。
[TrackBack URL: http://www.mylab.jp/diary/tb.rb/20080807]