ハウツー記事

解説

ハウツー記事は、「パスワードを変更する」「請求書をダウンロードする」のように、利用者がやりたいことを1つ決めている場面で読む記事です。記事の中心は番号付きの手順で、読み手が手順どおりに操作すると目的を達成できる構成にします。読み手はすでに目的を分かっているため、機能の背景や仕組みの説明は最小限にとどめます。

種類

ヘルプ記事は、読み手の目的によって、たとえば次のように分けられます。ハウツー記事は、目的を持った読み手に操作の道筋を示す種類にあたります。

• チュートリアル：初めて使う人が、操作を体験しながら基本を学ぶ記事
• ハウツー記事：やりたいことが決まっている人に、達成までの手順を示す記事
• トラブルシューティング記事：うまくいかない人に、原因の切り分けと解決方法を示す記事
• リファレンス：設定項目や料金など、調べたい事実を一覧で示す記事
• 説明記事：機能の考え方や仕組みを理解してもらう記事

実務での使われ方

ハウツー記事の題名は、「〜する方法」「〜したい」のように、読み手が達成したいことをそのまま書きます。本文は、前提条件、手順、完了したことの確認方法の順に並べると、読み手が迷いにくくなります。さらに、手順の途中で補足が長くなる場合は、説明記事やリファレンスへのリンクに分けると、手順を追う読み手の邪魔になりません。

注意点

操作手順は、記事の中で示す工程の連なりを指します。一方で、ハウツー記事は、操作手順を中心に組み立てた記事そのものを指します。また、トラブルシューティングは、問題の原因を絞り込んで解決する作業であり、目的を達成する道筋を示すハウツー記事とは読み手の状況が異なります。したがって、1本の記事に両方の内容を詰め込まず、記事を分けてリンクでつなぎます。