【ブログ投稿】コツ２：小学生が読んで分かる文章でOK

2020年6月24日

小学生が読んで理解できることが"ベスト"

２つめのポイント、
「小学生が読んで分かる文章でOK」について
お伝えしていきます。

“でOK“と伝えましたが、“ベスト"といってもいいでしょう。

とにかく難しい言い回しはしなくて大丈夫です。

専門用語も使わなくて大丈夫

加えて、専門用語なども必要最低限に抑えると、
プログラムに携わったことがない方でも読みやすくなります。

可能であれば、言い換えたり、簡単な補足を入れてあげるのもいいでしょう。

こんなイメージです。

例えば、あなたが
プロフェッショナルコースの生徒さんに
「このメソッド呼ぶところ、引数がないよーって怒られているよ。」
とアドバイスしたとします。

おそらくこのアドバイスは、
読んでいる親御さんの多くは伝わらないと思います。

そのため、この場合であれば、
専門用語を使っていますが、発言を変えることは難しいので
【補足として情報を書く】という方法をとってもいいでしょう。

■ サンプル

A「あれ、なんかエラーがでちゃった。」 さ「ちょっと見てもいいかな？」 A「うん。」 さ「うんうん。これは、メソッド呼ぶところ、引数がないよーって怒られているみたいだね。」 今回のエラーでは、 処理をお願いする役割をもつメソッドが、 「お願いした先で使う道具（引数）がないよ」 と教えてくれていたものでした。 そこで、Aくんには引数（今回は、数字）を・・・

イメージが伝わっていれば、
全く同じような感じにしなくてもOKです。

自分なりにでOKです。
伝わるように工夫してみてくださいね。