ノンプロ研 技術ライティング講座 初級 第4期 5日目メモ
-
- いいね！0
こはた｜Python、GAS勉強中
@kohaku935
今日は、技術ライティング講座 5回目「文章を書く技術2」に参加します。 先週も言ってましたが、宿題が積まれてます。 #ノンプロ研 #ライティング講座
2021-12-03 19:59:23
こはた｜Python、GAS勉強中
@kohaku935
課題（現状となるべき姿のギャップ）を解決して、なるべき姿に慣れる。 くだらんエラーでどん詰まりもよくする。寄り道がものすごい多い。 その寄り道を、ログを取っておかないと。 #ノンプロ研 #ライティング講座
2021-12-03 20:12:56
こはた｜Python、GAS勉強中
@kohaku935
コストの低い課題解決方法を提示すること＝価値になる コスト＝価値 プログラミング習得まで、180～300時間と言われる。 この範囲でも180時間で習得できれば、コストが低くなる。 #ノンプロ研 #ライティング講座
2021-12-03 20:14:32
こはた｜Python、GAS勉強中
@kohaku935
良い文章とは、より少ない時間で課題を解決できる文章。 コストを下げるために目標を下げてしまうことがある。 コピペでOKのほうがラク。 それでは、本来の目標からずれてしまう。 #ノンプロ研 #ライティング講座
2021-12-03 20:17:36
こはた｜Python、GAS勉強中
@kohaku935
目標を下げずに、早く目標達成できる文章を書くには？ ・知られていない方法を発見して書く。 →だいぶハードルが高い ・ターゲットマッチした文章を書く ・より早く理解できる文章を書く #ノンプロ研 #ライティング講座
2021-12-03 20:21:28
こはた｜Python、GAS勉強中
@kohaku935
一般的に読みやすい文書＝リーダブルな文書 参考図書：リーダブルコード amazon.co.jp/%E3%83%AA%E3%8… #ノンプロ研 #ライティング講座
2021-12-03 20:22:35
こはた｜Python、GAS勉強中
@kohaku935
文書だけじゃなく、リーダブルなコードも書けるようになる、1度で2度おいしいやつ。 #ノンプロ研 #ライティング講座
2021-12-03 20:23:22
こはた｜Python、GAS勉強中
@kohaku935
リーダブルでググったら、面白そうな記事を見つけたので、後で読もう。 clear-code.com/blog/2021/9/22… #ノンプロ研 #ライティング講座
2021-12-03 20:26:15
こはた｜Python、GAS勉強中
@kohaku935
リーダブルに書くための作法 ・1度に1つのことを書く ×たくさんのトピックをいっぺんに説明する 〇1つのトピックを説明する。1文、段落のかたまりにする。混在させない。 #ノンプロ研 #ライティング講座
2021-12-03 20:36:36
こはた｜Python、GAS勉強中
@kohaku935
・明確にする ×何を指しているか？わからない ×2重否定で難解にする ×あれ、それ、これを使う 〇単語で明確に示す 〇メタ情報をつける #ノンプロ研 #ライティング講座
2021-12-03 20:45:35
こはた｜Python、GAS勉強中
@kohaku935
・ガイドする 接続詞を使う →普段から文章を読んで、どんな時に使うか？意識してみよう。 …意識して、使えていないなぁ。 予告 →この後の道筋を示す 立ち止まらせる →質問、表などを入れる 補足する →予告と似てる #ノンプロ研 #ライティング講座
2021-12-03 20:56:48
こはた｜Python、GAS勉強中
@kohaku935
・見た目をやさしく レイアウトを整える。 句読点、分割する、空行を挟む。 ひらがな、強調する。 図、表を使う。 #ノンプロ研 #ライティング講座
2021-12-03 21:03:35
こはた｜Python、GAS勉強中
@kohaku935
ひらくの具合がわからん。 同じ質問しようとしてた。 ひらくといいワードがあるらしい。 ツールで、ひらいたほうがいい単語を教えてくれる。 VSCodeのプラグインがあるらしい。前の講座の資料を確認しよう。 #ノンプロ研 #ライティング講座
2021-12-03 21:06:19
こはた｜Python、GAS勉強中
@kohaku935
Markdown文書の日本語をチェックするVS Code拡張機能「テキスト校正くん」 tonari-it.com/vscode-text-co… #ノンプロ研 #ライティング講座
2021-12-03 21:08:10
こはた｜Python、GAS勉強中
@kohaku935
・一貫性を持たせる 用語、パターンなどを統一。 固有名詞の揺れ。 …やってしまってるな。気をつけねば。 長音。 …最近は長音は省略しないで書いている。 #ノンプロ研 #ライティング講座
2021-12-03 21:13:54
こはた｜Python、GAS勉強中
@kohaku935
・適切な密度で。 密度＝文字数当たりの情報量 分かっていることを説明しない。 情報密度の高い単語、概念を獲得することが、プログラミング学習のゴール。 #ノンプロ研 #ライティング講座
2021-12-03 21:26:19
こはた｜Python、GAS勉強中
@kohaku935
Q:前の記事で説明したけど、今回の記事でも同じ単語を説明したほうがいいか？ A:シリーズ化している場合は、省略してもOK。 シリーズしていない場合、この記事に到達する人がどういう人なのかを考えて、説明するかどうか？を検討する必要あり。 #ノンプロ研 #ライティング講座
2021-12-03 21:29:52
こはた｜Python、GAS勉強中
@kohaku935
・自然な構造にする 粒度をそろえる。 粒度とは？ →構成単位の粗さ、大きさ。 自然に並べる。 #ノンプロ研 #ライティング講座
2021-12-03 21:38:33
こはた｜Python、GAS勉強中
@kohaku935
MECEとは？ みーしー。 ロジカルシンキングの基礎。もれなく、ダブりなくと訳す。 executive-link.co.jp/column/3324/ #ノンプロ研 #ライティング講座
2021-12-03 21:38:42
こはた｜Python、GAS勉強中
@kohaku935
宿題の数が少ない。 だけど、1つ1つが重い。 かつ、前の宿題からつづきものになってる。 前のをやってないから、また積まれてしまう。 #ノンプロ研 #ライティング講座
2021-12-03 21:41:18