1 教示文の基本

1.1 定義役割

教示文とは、利用者に対して特定の行動や判断を促すために、意図をもって提示される指示・説明の文章である。役割は、何を、どの順序で、どの条件の下で実行すべきかを明確化し、誤解による手戻りや不達成を抑えることにある。あわせて、利用者が迷わないための前提制約判断基準も同時に与える。

1.2 対象とする利用者

教示文は、読み手の知識量、経験、技能、状況に適合して設計される必要がある。初学者向けには用語の定義や具体例が重要になる一方、熟練者向けには省略や参照が有効となる。また、同じ作業でも職務権限や環境(端末、権限、所持している情報)が異なる場合、対象範囲を意図的に切り分けなければ誤用が増える。

1.3 成果指標(良い教示文の基準)

良い教示文は、到達可能性、正確性再現性、負荷の低さの観点から評価できる。具体的には、利用者が手順の途中で停滞する回数が減ること、誤った操作が発生した際に原因を切り分けられること、完了までの時間が過度に伸びないことが指標となる。さらに、記述の曖昧さが減り、同一条件下で複数の人が同様の結果に到達することも品質の目安である。

2 構成要素と書き方

2.1 目的と範囲の明確化

2.1.1 想定される行動

2.1.1.1 いつ・誰が・何をするか

教示文の最初に、開始条件(いつ)、責任主体(誰が)、対象となる対象物や目的物(何を)を整理する。たとえば「申請を行う前に」「担当部署の担当者が」「所定の様式入力する」といった形で、時間・権限・対象を最小限の文で示すと解釈の幅が狭まる。ここで曖昧な主語や、状況の判断を利用者に丸投げしないことが重要である。

2.2 前提条件の提示

前提条件は、手順が成立するために必要な情報、準備、制約条件の集合である。具体例として、必要なアカウント、利用可能な権限、参照すべき画面や帳票、使用する環境(ブラウザ種別、端末、ネットワーク条件)、所要時間の目安などが含まれる。前提が満たされない場合の挙動や代替手段も可能なら明記し、利用者が別ルートへ迷走する事態を抑える。

2.3 手順の記述

手順は、実行順序が変わらない形で提示するのが基本である。番号付けや段階分けにより、現在位置が把握しやすくなり、途中での取り違えが減る。各ステップでは、操作対象、入力内容の種類、選択肢の意味(可能なら)、確認ポイントをまとめて書く。加えて、待ち時間や画面切替などの“発生しやすい挙動”を補足すると、利用者の不安を抑えられる。

2.4 注意事項と例外

注意事項は、失敗時の損失が大きい操作や、誤解が起きやすい境界条件中心に記述する。例外は、通常手順が適用できないケース、または分岐が必要な状況であり、条件をもって切り分ける。たとえば「特定の入力形式ではエラーが出るため、形式を変更する」「権限がない場合は別の担当へ依頼する」といった形で、次に取るべき行動までをセットにすることが望ましい。

2.5 期待される結果

期待される結果は、完了後に得られる状態、表示、出力、確認方法を具体化する。これにより、利用者は“成功の定義”を自分で探す必要がなくなる。結果が複数ある場合は、優先度や確認順を示すとよい。さらに、結果が得られない場合の確認先(ログ通知問い合わせ窓口)も簡潔に添えると、学習コストや対応時間が抑えられる。

3 教示文の種類と用途

3.1 学習指導(カリキュラム)

学習指導の教示文は、知識獲得と技能の定着を同時に支える。単発の操作説明にとどまらず、到達目標、評価の観点、練習機会、振り返りの指針を含む。段階的な課題設定が重要であり、学習者が誤りを学習資源として扱えるように、解釈可能なフィードバックの導線を設計する。

3.2 オペレーション手順(業務・運用)

業務・運用向けの教示文は、正確性と再現性が中心になる。複数名が関与する場面では、責任分界、記録の取り方、承認の要否を丁寧に示すと事故が減る。加えて、緊急時や例外が起きた際の優先順位(何を先に止め、何を先に回復するか)を定めることで、判断負荷を下げられる。

3.3 製品・サービスの利用説明

製品・サービスの教示文は、ユーザージャーニーに沿って“行うこと”を最短経路で示すことが多い。導入、設定、日常操作、トラブル時の切り分けという流れで整備される。用語の説明と、画面の位置・名称の一致(どのボタンか、どの表示か)を重視し、利用者が誤った機能を選ぶ確率を下げる。

3.4 行動喚起(フォーム、申請、設定)

行動喚起型の教示文は、入力や選択を完了させるための“次の一手”を短く提示する傾向がある。入力項目の意味、必須・任意、検証(形式チェックや矛盾チェック)の条件を分かりやすく示し、フォーム完了までの迷いを減らすことが目的となる。申請や設定では、誤記が生む影響が大きいため、確認画面の見どころや取り消し手段も併記する。

4 表現設計と改善

4.1 語彙と文体(読みやすさ)

読みやすさは、語彙の難易度、文の長さ、命令形の一貫性、否定表現の扱いに影響する。専門用語を使う場合は、同一文章内または直近で意味を補うと理解が安定する。文体は、利用者が迷いにくいように“何をすべきか”を中心に据え、文意の解釈が分散しない表現にする。可能なら能動的な記述に寄せる。

4.2 図表・箇条書きの活用

図表や箇条書きは、情報の構造化に有効である。比較、手順、注意点の列挙などは箇条書きが適する一方、関係性や流れは図解が向く。表は項目の対応関係が明確な場合に有効である。大事なのは、装飾ではなく“判断に必要な要素”だけを載せ、読み手が重要箇所へすぐ到達できる形に整えることである。

4.3 用語の統一

教示文では、同じ概念に別名を使わないことが理解の安定につながる。画面上の表示名、帳票の項目名、業務上の呼称を一致させると、利用者が照合する負荷が下がる。表記ゆれ(表記の揺れ、略称の増減、カナ表記の差など)も、可能な限り事前にルール化して排除する。統一ルールが整うほど、改訂時の品質管理も容易になる。

4.4 よくある誤解と対策

よくある誤解は、前提の読み落とし、手順の順序入替、条件分岐の見落とし、確認ポイントの欠落などに集約される。対策としては、誤解が起きやすい箇所に限って“何が違うのか”を明示する方法がある。たとえば「AではなくB」「この段階では提出しない」など、禁止・誤りを最小限の例で示すと効果的である。また、誤りが起きた際の復帰手順(どこに戻り、何を再確認するか)を添えると影響が小さくなる。

4.5 フィードバックと改訂手順

教示文は固定物ではなく、運用実績をもとに改善されるべきである。改善の入口として、問い合わせ内容、失敗ログ、学習者のつまずき、操作時間の偏りなどを収集する。改訂手順では、変更点の記録、影響範囲の確認、再テスト、利用者への反映(告知や差分提示)を含めると混乱が減る。さらに、改訂が繰り返される場合に備えて、根拠(なぜ変えたか)を残すことが望ましい。