ドキュメント作りで一番大切なのは、相手に考えさせないこと

野村 輝のプロフィール画像
エンジニア 野村 輝

372 view

サイトを更新するための資料を作成したときのこと。

この手のマニュアルのような資料は、単純に手順を整理して示すだけでなく、どうすれば担当者の作業の負担を軽減し、誤解なく、ミスなく、作業を完遂できるかを考えなければならない。

わたしの考えでは、一番大事なのは「相手に考えさせないこと」である。

慣れない作業をおこなうときの一番のストレスは、不安感である。選択肢はなるべく与えず、シンプルに一つの方法を順番に示すことで、迷いなく作業を進めることができる。

例えば、こういう方法もあるけど、別の方法もあるよ、やりやすい方を選択してね!という表現は、一見親切そうに見えるが、作業が慣れていない人にとっては、迷ってしまうポイントになる。

そのシステムを作った人は、機能のすべてを熟知しているがゆえに、あれも、これもと、すべての機能を説明しようとしてしまう。でもこれが、分かりにくさ、不安の一番の要因になる。

例えば、電化製品などで、マニュアルが難しく、結局読んでもらえず、お問い合わせやクレームが全然減らなかったら、そのマニュアルを丁寧に時間をかけて作った意味がない、となってしまうが、それと同じことである。

ドキュメントの一番の目的は、仕様を文章にまとめることではない。それを読む人とのコミュニケーション。利用する人のことを考え、ストレスや不安感を感じさせず、ミスを誘発しないドキュメント作成を、これからも心がけたい。

関連する日報

    「気が利く」は才能ではなく、磨けるスキル

    273 view

    永松 奈央美のプロフィール画像
    永松 奈央美 エンジニア
    「忙しいけど大丈夫」と言われたとき、マネージャーは何を見るべきか

    404 view

    野上 恵里のプロフィール画像
    野上 恵里 コンサルタント
    「あの人がいるから頑張れる」は組織の危険信号

    840 view

    西岡 紀子のプロフィール画像
    西岡 紀子 ライター
    なぜ数字報告は、聞くだけで不安になるのか?

    711 view

    奥原美穂子のプロフィール画像
    奥原美穂子 経営企画
    技術に疎くてもわかるXのアルゴリズム解説:公開コードから読み解く仕組みとフォロワー増加戦略

    3,110 view

    枌谷 力のプロフィール画像
    枌谷 力 代表取締役
上に戻る