ノンプロ研技術ライティング講座【第1期】第5回
- ntakahashi0505
- 1107
- 1
- 0
- 67
目標を下げず、速く目標達成してもらう文章を書くには? ・これまで知られてない方法を発見して書く ・ターゲットを絞って、ベストな文章を書く #ノンプロ研
2021-02-15 20:26:58#ノンプロ研 読みやすい文章の書き方のお作法 分かってはいるつもり。 でもそれが「早く」書けない私。
2021-02-15 20:28:04「これまで知られてない方法を発見して書く」 すでに誰かが書いてるなら、それを紹介するだけでいいからね。 少しでも自分のエッセンスがないと。 #技術ライティング講座 #ノンプロ研 pic.twitter.com/LuQ9YPIkAM
2021-02-15 20:29:03【リーダブルな文章を書く作法を知る】 「きまったやり方」や「しきたり」は、書くための選択肢を減らすテクニックでもあります あらかじめルールが決まっていると、悩む回数も減りますよね #ノンプロ研
2021-02-15 20:31:20【リーダブルに書くための作法①】 1.一度に一つのことを ・ひとつの要素に2つ以上を混在させない (文、段落、項、節、章、部) ・次の要素の前に、回収して結論づける ・混在している場合は、分割する →「回収して結論づける」とわかりやすくなりますね #ノンプロ研
2021-02-15 20:34:52おしゃべり得意じゃないんだけど、次々つながった文章になりがち。 なんでだ? #ノンプロ研
2021-02-15 20:38:13文章もコードも同じで、1文で複数のことを書いていると読みづらい。 言われたらわかるけど普段意識してないな。 コードもメソッドつなげて一気に書くの好きだな… #ノンプロ研
2021-02-15 20:38:40技術ライティング講座では「読みやすさ」にフォーカスしてそのための作法をみていく。読みやすくするために、まず、短く分ける。一度にひとつのことを論じる。#ノンプロ研
2021-02-15 20:39:38【リーダブルに書くための作法②】 2.明確にする ・主語と述語の関係を明確に ・指示語(こそあど言葉)を使いすぎない ・二重否定を避ける ・逆説ではない「~が」を避ける ・受動態を避ける ・メタ情報(情報を説明するための情報)を付与する #ノンプロ研
2021-02-15 20:39:53#ノンプロ研 らしく、ソースコードを見ながら具体例を確認しています。 「二重否定を避ける」の具体例 ↓ ①If Not IsRed <> True Then ②If IsRed Then →②の方がわかりやすいですね
2021-02-15 20:41:36明確にする ややこしく欠かない 肯定文で書く シンプルに書く ただし省略しすぎない 読み手の負担に配慮する #ノンプロ研
2021-02-15 20:42:03