ノンプロ研 技術ライティング講座 初級 第4期 4日目メモ

2021/11/26 技術ライティング講座第4日目の自分のツイートまとめました。
1
こはた|Python、GAS勉強中 @kohaku935

技術ライティング講座 4回目参加しています。 重い宿題がたまっております。首が詰まってきてます… #ノンプロ研 #ライティング講座

2021-11-26 20:01:41
こはた|Python、GAS勉強中 @kohaku935

アイスブレイクタイム 「とにかく書き始めることが大事」 タカハシさん #ノンプロ研 #ライティング講座

2021-11-26 20:09:08
こはた|Python、GAS勉強中 @kohaku935

宿題は早めの着手を。 悩んだら、Slackで質問しよう。 #ノンプロ研 #ライティング講座

2021-11-26 20:09:45
こはた|Python、GAS勉強中 @kohaku935

書き始める前に、選択肢を減らす方法の1つ。 「ターゲットを決める」 ここ、大事なパート。 #ノンプロ研 #ライティング講座

2021-11-26 20:12:00
こはた|Python、GAS勉強中 @kohaku935

読者の明確なイメージがあることで、その読者さんに伝わるように書けばいいので、書くのはラク。 #ノンプロ研 #ライティング講座

2021-11-26 20:12:59
こはた|Python、GAS勉強中 @kohaku935

ターゲットの設定。 書きはじめは、細かい設定は不要。シンプルでOK。 #ノンプロ研 #ライティング講座

2021-11-26 20:14:38
こはた|Python、GAS勉強中 @kohaku935

VBAの書籍はたくさんあるが、学習に苦労した。 ・知識が分散。バラバラなところから、自分が作りたいもののために知識を組み合わせが難しかった。 ・Web上のコードは、自分仕様に応用できない。 #ノンプロ研 #ライティング講座

2021-11-26 20:17:39
こはた|Python、GAS勉強中 @kohaku935

隣ITで、シリーズ連載を開始。 コードを少しずつ載せて、少しずつ理解しながらツールができていくようになる。 #ノンプロ研 #ライティング講座

2021-11-26 20:19:07
こはた|Python、GAS勉強中 @kohaku935

「リーダブルコード」との出会い。 VBA版あったらいいのになぁ。 VBAは一人で作っている人が多い。コードを書くけど、書き方がバラバラ。 可読性が低い。 #ノンプロ研 #ライティング講座

2021-11-26 20:21:27
こはた|Python、GAS勉強中 @kohaku935

自分が読みたかった文章を書いていく。 ターゲット:少し前の自分 メリット: ・自分のことは良くわかる。自分が読みやすい文章を書けばよい。 ・内容にリアリティが出る。 ・自分の複数に適した教材ができる。 #ノンプロ研 #ライティング講座

2021-11-26 20:23:53
こはた|Python、GAS勉強中 @kohaku935

・読者の環境、背景 技術面の背景は押さえておく。 なぜ学ぶのか?が、環境や背景の中に、隠されていることもある。 #ノンプロ研 #ライティング講座

2021-11-26 20:31:10
こはた|Python、GAS勉強中 @kohaku935

シリーズ連載のメリット。 説明を細かくすることで、記事がたくさん作れる。 #ノンプロ研 #ライティング講座

2021-11-26 20:33:17
こはた|Python、GAS勉強中 @kohaku935

読者の課題・目的 重要なポイント。 書くことの価値を生み出す。 学習後の姿にたどり着くために、よりコストの低い課題解決の方法を書くことができる。 #ノンプロ研 #ライティング講座

2021-11-26 20:38:03
こはた|Python、GAS勉強中 @kohaku935

読者の知識 書籍の場合、少しずつ言語を獲得できるように進めていける。 ブログの場合、知っている単語って何だろう?ということを考える必要がある。 …いつも悩むところです。この単語も説明したほうがいいかな、と。 #ノンプロ研 #ライティング講座

2021-11-26 20:45:41
こはた|Python、GAS勉強中 @kohaku935

初心者向けのほうが、前提情報の説明をする必要があるので、難しい。 #ノンプロ研 #ライティング講座

2021-11-26 20:47:42
こはた|Python、GAS勉強中 @kohaku935

想定よりも、やや下の知識レベルに向けて書いていくのが良い。 #ノンプロ研 #ライティング講座

2021-11-26 20:52:00
こはた|Python、GAS勉強中 @kohaku935

省略部分については、後で説明することを、書いておくのも良い。 #ノンプロ研 #ライティング講座

2021-11-26 20:54:21
こはた|Python、GAS勉強中 @kohaku935

書き始める前に、選択肢を減らす方法 3.構造を考える 構造化とは? 構成要素と、構成要素間の関係を整理する。 #ノンプロ研 #ライティング講座

2021-11-26 20:57:04
こはた|Python、GAS勉強中 @kohaku935

構造化といえば、DB。 GAS、VBAの初級講座で習う「構造化データ」をすぐに思い出しました。 #ノンプロ研 #ライティング講座

2021-11-26 20:59:55
こはた|Python、GAS勉強中 @kohaku935

1.グルーピング ・人が同時に意識できる数は、4、5個 ・すべてのスコープで、4~5個になるよう分類していく。 ・階層に分ける(文→段落→項→節) #ノンプロ研 #ライティング講座

2021-11-26 21:09:42
こはた|Python、GAS勉強中 @kohaku935

2.グループに名前を付ける ・グルーピングと同時に作業。 ・グループにつけた名前=章、節の名前 ・「見出し」分かりやすく、意味があるものに #ノンプロ研 #ライティング講座

2021-11-26 21:24:47
こはた|Python、GAS勉強中 @kohaku935

3.順番を決める ・順番の決め方 時系列、作業順、空間的など… 知識の獲得・理解のしやすさ(簡単→難しい)… 定義(例:構文)→使用(例:コード) ・フレームワーク いつもはまるとは限らない。参考にする。 #ノンプロ研 #ライティング講座

2021-11-26 21:24:48
こはた|Python、GAS勉強中 @kohaku935

文章の構造化は、難しい。 実際に書いていると、修正することもある。 でも、決めておいた方が書くのはラクになる。 #ノンプロ研 #ライティング講座

2021-11-26 21:29:16