書評：『はじめての技術書ライティング』

期待したような本ではなかった。読む側として期待しすぎだったか。

ちょっとタイトル詐欺感は否めない。率直に言って、あまりオススメの本ではない。

概要

はじめての技術書ライティング―IT系技術書を書く前に読む本 (NextPublishing)

作者: 向井領治
出版社/メーカー: インプレスR&D
発売日: 2018/03/30
メディア: Kindle版
この商品を含むブログを見る

はじめての技術書ライティング―IT系技術書を書く前に読む本 - 向井領治 - Google ブックス

タイトルのとおり、「ライティング」つまり書くことに重点を置いている。人文系や科学論文以外の文章の書き方の本を目指したらしい。

「はじめての」とタイトルにある割には特に工夫があるわけではなく、それなりに普段本を読んでいて、かつパソコン自体に慣れている人向け。

なお、本書はIT系の技術書や読み物を書きたい初心者に向けて、一般的な書き方を解説するものです。技術文書の書き方に関する資格試験や、企業内での製品マニュアル制作などの目的は想定していません。
向井領治. はじめての技術書ライティング―IT系技術書を書く前に読む本 (NextPublishing) (Kindle の位置No.33-35). インプレスR&D. Kindle 版.

一般的な書き方なら他の本でいいのではと思う。

内容について

冒頭部で「技術文書の3要件」として、以下のように書いている。

（前略）技術解説の文章を書くときは、①正確であること、②論理的であること、③平易であること、の3点に注意する必要があります。
向井領治. はじめての技術書ライティング―IT系技術書を書く前に読む本 (NextPublishing) (Kindle の位置No.173-174). インプレスR&D. Kindle 版.

おかしくはないが、技術文書の3要件はさすがに言い過ぎではないでしょうか（いきなり技術書から技術文書に飛躍しているのは大いに疑問）。

正論なので文句をつけにくいが、なんとも違和感がある。

一応、IT系固有の注意点も解説されているが、大筋としてはフォーマルな文章の書き方の範囲であまり特殊なことは書いてない。

「《筆者の場合》」というノウハウを紹介している項目は有益なので退屈な場合はそこだけ読んでもいいと思う。

電子書籍としてはちゃんと表のテキストをコピーできたり*1、かなりまともな作りでこの点は好感が持てる。

AdobeのAcrobatを使った原稿の公正のやり取り、スクリーンショットの撮影に使うソフトウェアについてはかなり詳しく解説がある。

一般的な商業出版ならではの注意事項やヒントについては参考になる。残念ながら組版ツール側の都合からくる注意点が主体。

ただ、ごく一部の、もっと先進的なワークフローで書籍を解説している会社の事例については全然言及されていない。バージョン管理システムによる原稿の管理なんて夢のまた夢。

著者の世代の問題か、技術書を書いていると入ってもそれあくまでツールの入門書であって、「節子、それ技術書ちゃう、解説書や」という感じがする。

面白いのは「1/3」と「3分の1」のどちらがいいかという話。本の著者は後者を勧める理由として「音声読み上げツールを使う可能性がある」からという理由を提示している。年齢的な問題なのか、それとも積極的にオーディオブックなどを利用しているのか。どちらにせよ珍しい視点。

疑問に感じた箇所

データ量の単位の表記の説明で、「b」、「B」それぞれ1文字をビット、バイトという単位の表記として紹介している。間違ってはないが、普通は「1bit」、「1byte」とは書いても「1b」や「1B」とはめったに書かない（表やデータシートは別）。

「1b」や「1B」という表記だと鉛筆の芯、あるいは番号付きの箇条書きの見出し、図表の番号などと紛らわしい。もちろんKB、MBのように接頭辞のついた形式ではよく使う。その直後に通信速度の単位について、ビットとバイトの違いに注意しろと書いてあるだけに非常に残念。

また、KiBやMiBついても言及なし。KBやMBでは1,000倍かあるいは1,024倍かは注意すべきポイントのはず。表記について注意喚起するならそこは徹底してほしい。

もう一点、難読漢字をどうするか、ルビを表記することに対してこの本の著者は否定的。これは納得しかねる。活字を並べていた時代はコスト的に厳しかったかも知れないが、紙と電子版で見せ方を変えることもできるのだからルビは積極的に使うべき。技術的な観点から言えば少なくともHTML5には<rub>タグがある。

紙媒体と電子書籍について

注釈についての注意書きの箇所。注釈に関する文章なんだけど電子書籍に関する見解について。

（前略）そもそも脚注はできるかぎり使わず、本文の中で記述することをおすすめします。脚注は本文とは別の場所へジャンプする必要があるため読みづらくなりますし、電子書籍ではページの移動が印刷書籍よりも面倒だからです。
向井領治. はじめての技術書ライティング―IT系技術書を書く前に読む本 (NextPublishing) (Kindle の位置No.1499-1501). インプレスR&D. Kindle 版.

これは疑問。電子書籍リーダーの問題をメディアの問題と混同している。あるいは電子書籍リーダーの機能を知らないか。

注釈のリンクをクリックしたあと前のページに戻れるし、KindleのPage Flip機能や検索などページの移動については紙より便利。
どうも認識が古いんではないか。