SHOEISHA iD

※旧SEメンバーシップ会員の方は、同じ登録情報(メールアドレス&パスワード)でログインいただけます

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

テクニカルライティング作法・外伝

「辞書を曳く?」~ソフトウェア開発者に贈るテクニカルライティングの極意

テクニカルライティング作法・外伝 第3回

  • X ポスト
  • このエントリーをはてなブックマークに追加

表現を変えたいときに引く

 文章に変化を付けたいときも、辞書を引きましょう。

 同じ言葉が続けて出てくると、文章が単調になります。変化を付けるため、別の言葉にしたくなります。といっても、テクニカルライティングでは、名詞を安易に変えてしまうわけにはいきません。例えば、最初に「オーバーフロー」と書いて、次に出てくるときにそれを「桁あふれ」と書いてしまうと、読者は違うことだと誤解するかもしれないのです。動詞も、例えばファイルを「保存する」と「セーブする」は(この例はまず大丈夫ですが念のために)、どちらか一方だけに統一します。そういった誤解をあまり心配せずに表現を変えられるのは、形容の言葉です。

 例として「Aさんの書いたコードはすばらしい。Bさんのもすばらしい。」という文を考えてみましょう。「すばらしい」が繰り返し登場してダサいですね。「すばらしい」を言い換える言葉を探してみましょう。

 そのような目的には、シソーラス(類語)の載っている辞書が適しています。Web上でもそのような辞書が公開されています。「類語 同義語 辞典」といった検索ワードでググってみてください。

 私の使っている学研国語大辞典には「すばらしい」のシソーラスが掲載されています(次の画像)。「見事(みごと)です」や「天晴(あっぱれ)です」あたりは使えそうですね。

学研国語大辞典のシソーラス
学研国語大辞典のシソーラス(前述のEBWin4で表示)

 また、全文検索も活用できます。電子辞書によっては、全文検索の代わりに説明文を対象に検索できるものもあります。Webの辞書には、そのような全文検索機能を備えているサイトもあります。そんな機能がWebサイトにないときは、サイトを指定してググればいいですね(例えばGoogleなら「検索オプション」のページで「サイトまたはドメイン」欄に指定します)。

 手元の辞書を「すばらしい」で全文検索してみると、次の画像のような言葉が見つかりました。いずれも1998年発行の電子辞書です。

故事ことわざ辞典(学研)
故事ことわざ辞典(学研、EBWin4で表示)
学研漢和大字典
学研漢和大字典(EBWin4で表示)

 故事ことわざ辞典からの「舌を巻く出来栄えです」、漢和大字典の「絶妙(ぜつみょう)です」/「素敵(すてき)です」(「絶妙」の3つ上)なども使えそうです。

まとめ

 辞書には、知らない単語を調べるほかに、使い分けを調べたり言い換えを調べたりといった活用法もあります。昔は図書館で机の上に何冊も辞書を広げて調べたものですが、今では電子辞書やWebを使って場所も時間も取らずに探索できます。テクニカルライティングに限らず文章を書くときには、辞書を上手く使いましょう。

関連リンク

この記事は参考になりましたか?

  • X ポスト
  • このエントリーをはてなブックマークに追加
テクニカルライティング作法・外伝 連載記事一覧

もっと読む

この記事の著者

biac(ばいあっく)

HONDA R&Dで自動車の設計をやっていた機械屋さんが、技術の進化スピードに魅かれてプログラマーに。以来30年ほど、より良いコードをどうやったら作れるか、模索の人生。わんくま同盟の勉強会(名古屋)で、よく喋ってたりする。2014/10~2019/6 Microsoft MVP (Windows Devel...

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この記事は参考になりましたか?

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine(コードジン)
https://codezine.jp/article/detail/11386 2019/03/01 11:00

おすすめ

アクセスランキング

アクセスランキング

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

アクセスランキング

アクセスランキング