オススメドキュメントにジョブ設計やシステム構成を書くときがあるのですが、自信をもって書けてると思えません。いつも句読点や受動態表現など悩みながら書いています。そんな思いを持っているときに本屋を物色したら、このような本を見つけました。単行本(ソフトカバー)感想からいうととてもいい本でした!技術者が書くドキュメントを読みやすくする工夫が豊富に書かれています。「読みやすくするため」のせいか、本自体も読みやすく2,3時間程度で一気に読めてしまいました。いえ中身は実用的なものばかりで、おーこれこれ!っといいたくなるコツが書かれています。文を長くしないついついやっちゃうんです。xxxはyyyなので、zzzというときにはaaaaaをします。いったように理由→どうするを書く、つまり1文の中に理由などを詰め込もうとしてしまうんです。文が長くなってわかりにくくなってしまいます。1文は50文字までにすると読むほうもサラサラと読めるそうです。「形容詞や名詞句ではなく動詞でズバリと書く」BEFORE会員登録が必要です。↓AFTER会員登録をしてください。「~をする必要があります。」これ!もうねーつい書いてしまうんですよ!ほんとに。手順書を書いたりするときにやらなければならない前提条件を書くことがあります。読み直してみると~が必要と書いてあっても、じゃあそれをするにはどうすればいいんだよ!!っと自分のドキュメントにツッコミを入れたくなります。具体的に指示を書くのがいいそうです。「~などを多用しない」これもよくやっちゃいます。対策としてはなどを省くか、例示したものの総称を書くのがいいそうです。「ドライバーやレンチなど」→「ドライバーやレンチなどの工具」~などをつける時ってだいたい自信のなさが根底にあるんですよね。受動態と能動態を気を付けるこれもよく間違えます!!日本語の悪いクセなのかわかりませんが、読む人のことを考えて受動態表現=読む人への敬意と考えることが自分でもあります。人の文章を読んでもあきらかにおかしいのに受動態表現が乱発してることがありますよね。ユーザーがやる動作は能動態、起きる事象は受動態が基本だそうです。アイコンがタップされるとアプリが起動し、ログイン画面を表示します。↓アイコンをタップします。アプリが起動し、ログイン画面が表示されます。これで基準がわかるようになりました。申し訳ありません別に書きたいように書く、また読む人が理解できればいいじゃん!!っと考えていた時期もありました。いう人の文章を読んでるとこいつ幼いな!、または知的に成長しないやつなんだな、っと思うようになってきました。いう文章を書く人の仕事は適当なんじゃないのか?っと連想されてしまうんですよ。以前聞いたことがあるのですが、"大手企業の部長に企画書を見せたら「てにをは」しか直されず、年収2000万の人の仕事がこんなものなのかよ!"っというつぶやきがありました。それに対して別の人が、"かなり大きな額が動くからそういう小さなミスにも気づかない人なんじゃないのか?っという連想を防ぐ意味もある"っと聞いてかなり納得してしまいました。この本の中には他にも障害報告書の書き方例、ユーザーマニュアル、パワーポイントの書き方が記載されており、非常に勉強になるところが多くあります。冒頭の方で文章のロジックの重要性について章が割かれていました。私はここも重要なところと考えています。ここについては、以前読んだバーバラ・ミントの「考える技術・書く技術」がおすすめです。合わせて読むと文章の書く力がより効果的に表れるでしょう。単行本blog.suganoo.net翔泳社様がRTしてくれてけっこううれしい。園田誠出版社/メーカ...2018-09-03オブジェクト指向設計を学ぶためにオススメの本プログラミングを覚えてきたら、オブジェクト指向設計を学ぶの...2018-08-15「考える技術・書く技術」を読んでみた仕事で文章がもっと的確に書けたらなあ・・・・。はてなブログProSESでけっこう満足してるビッグデータエンジニア技術書好き。blog記事の超意訳)をqiitaに投稿しました。policyスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。