マニュアル査読
仕事でマニュアルを作成したので関係者に回覧し、査読してもらった。指摘された点はおおよそ以下の通り。
○統一すべき言い回し
・「下さい」と「ください」→「ください」で統一。
・「出来ます」と「できます」→「できます」で統一。
・「ディレクトリ」と「フォルダ」→「フォルダ」で統一。
○良くない言い回し
・箇条書冒頭の「すると」
・箇条書冒頭の「続いて」
・「現時点で」
・「処理の都合上」
・「～との兼ね合いで」
・「なるべく」
・「ある程度」
・「万が一にも」
・「サンプルで集めたもの」→「サンプル」
・「少しずつ」
・「瞬時で終了」
普段からマニュアルなるものを書き慣れていないのもあって、どうも「読み物調」になる傾向があるようだ。マニュアルは、曖昧・冗長を排除し、誰が読んでも簡単に正しい作業ができることが求められる。いつもは圧倒的にメールやブログを書いているので、当然これらとは意識的に書き方を区別する必要がある。まだまだ修行が足りないなぁ。