機能を増やす前に、説明をやさしくした

今日は、開発中の学習アプリで小さな教材追加を進めたあと、文字の見やすさと説明文をまとめて見直しました。

きっかけは、実際にアプリを使っていて感じた、

「文字が少し小さい」
「線が細くて読みづらい」
「説明が少し堅い」

という違和感でした。

機能や教材を増やすことも大切ですが、その前に、

初心者が読んで理解できること

も同じくらい重要です。

今回はそこを改善しました。

課題：内容は正しくても、伝わりにくい

学習コンテンツには、どうしても少し堅い表現が出てきます。

たとえば、

「許可を求める」
「同行者」
「宿泊客」

のような言葉です。

意味としては間違っていません。

でも初心者にとっては、

説明を理解するために、さらに説明が必要になる

状態でもあります。

そこで今回は、内容を簡単にしすぎるのではなく、

最初の説明を、もっと身近な言葉にする

ことにしました。

判断：難しい言葉を消すのではなく、分かる言葉から入る

全部をやさしい言葉へ置き換えればいいわけではありません。

必要な名前や考え方まで消してしまうと、あとで別の教材を見たときに困ることもあります。

そこで、

身近な説明 → 具体例 → 必要な名前や考え方

という順番を意識しました。

たとえば、

「許可を求める」

と最初から書くのではなく、

「してもいいですか」と聞く

と説明する。

「同行者」なら、

「一緒に行動している人」

のように言い換える。

難しい言葉をなくすのではなく、

難しい内容へ入るまでの階段を作る

という考え方です。

実際にやったこと：文字と説明を分けて改善

まず、アプリ全体で共通して使っている本文の文字設定を調整しました。

画面ごとに一つずつ直すのではなく、共通部分を変えることで、

文字を少し大きくする。
行間を広げる。
文字を少し太くする。

という変更をまとめて反映しました。

そのあと、説明文を一度に全部変更せず、いくつかのまとまりに分けて見直しました。

さらに、

図の説明。

比較の説明。

場面ごとの案内。

と段階を分けて確認しました。

結果：やさしくしても、大事な例外は残した

説明を簡単にするときに気を付けたのは、

正確さまで削らないこと

です。

初心者向けだからといって、

「いつもこうなる」

と単純化しすぎると、あとで混乱することがあります。

なので今回は、

まず分かりやすい説明を出す。

そのうえで、

「こうならない場合もある」

「場面によって使い方が変わる」

といった大事な注意は残しました。

分かりやすくすることと、雑にすることは別。

ここはかなり意識しました。

失敗：AIにやさしく直させても、そのままでは足りない

内部レビューでは、図の説明に少し曖昧な部分が見つかりました。

文章としては意味が通じても、

実際の例のどの部分を説明しているのか分かりにくい

箇所があったのです。

そこで、抽象的な説明を、

実際に表示している言葉と直接対応する形へ修正しました。

また、実機確認では自動操作がうまく進まない場面もありました。

でも画面を確認すると、必要な要素はちゃんと存在していました。

原因は、画面の準備が終わる前に確認を始めたり、大きくスクロールしすぎたりしたことでした。

アプリ本体を直すのではなく、

確認方法の方を修正

しました。

今回も、

確認失敗 = アプリの不具合

と決めつけないことが重要でした。

再利用できるルール

今回の開発から、今後も使えそうなルールを残しました。

① 初心者向けでは「正しい言葉」より先に「分かる言葉」を置く。

ただし、必要な考え方まで消さない。

② やさしくするときほど、重要な例外を削らない。

短くすることと、雑にすることは別。

③ 共通部分を直せるなら、画面ごとに同じ修正を繰り返さない。

文字設定のような変更は、共通部分から直した方が管理しやすい。

④ AIが書き直した文章も、実例と照らして確認する。

自然な文章でも、教材として分かりやすいとは限らない。

⑤ 自動確認が止まっても、すぐ本体を直さない。

まず、アプリ・端末・確認方法のどこに原因があるかを分けて考える。

次にやること

今回で、対象にしていた文字表示と説明文の見直しは進みました。

一方で、

すべての画面を実機で確認したわけではありません。

文字を大きくした状態。

画面読み上げ。

小さい画面。

今回追加した教材の音声。

など、まだ確認したい部分は残っています。

教材を増やすだけではなく、

「読めるか」「理解できるか」まで含めて作る。

今回は、そんな部分に目を向けた開発でした。

#AIプロジェクト日記 #Codex #AIエージェント #個人開発 #アプリ開発

関連する開発記録
今回と同じく、「機能そのものより、実際に使えるかを確認した」開発はこちらです。
→「テストが通っても、実機では最後まで操作できなかった」