ノンプロ研 技術ライティング講座【第6期】第4回

コミュニティ「ノンプログラマーのためのスキルアップ研究会」の技術ライティング講座 第4回のツイートまとめです。 コンテンツは「文章を書く技術1」です。
1
な~🍀GAS @GasNao703

自分の環境や背景をベースに書く ・選択肢が特定される ・説得力がある←逆に体験していないことを書くのは難しく、相当な「取材」が必要 #ノンプロ研 #ライティング講座 環境や背景の中に学ぶ理由があることもある

2023-08-01 20:26:34
hagy4nonpro @hagy4nonpro

自分の環境や背景をベースに書く事で 取材などの書き始めるコストを抑えられる。 #ノンプロ研 #ライティング講座

2023-08-01 20:26:43
たろ @100Taro

低コストで到達できる、コストをかけて到達した自分 両者の間をショートカットできれば「価値」になる #ノンプロ研 #ライティング講座

2023-08-01 20:30:05
な~🍀GAS @GasNao703

学習後をなるべき姿として、文章を書く #ノンプロ研 #ライティング講座 コストが少なく済むように文章で価値を提供する pic.twitter.com/EOYEmL9G6y

2023-08-01 20:30:19
拡大
拡大
Okapie @Okapie4

過去の課題解決のための学習を振り返り、よりコストの低い課題解決法を文章にすることで価値を提供できる #ノンプロ研 #ライティング講座

2023-08-01 20:31:20
たろ @100Taro

初心者は前提知識が少ない 前提知識を順序立てして、提供する必要がある #ノンプロ研 #ライティング講座

2023-08-01 20:33:54
な~🍀GAS @GasNao703

前提知識が必要 たくさんの前提知識を伝えながら説明する必要がある。 #ノンプロ研 #ライティング講座 pic.twitter.com/wxSFssIsWm

2023-08-01 20:34:28
拡大
Okapie @Okapie4

初心者は前提知識が少ない ある文章を読むには、そのための前提知識が必要 「オフチョベットしたテフをマブガッドしてリットにします」を思い出すw →ターゲットに合わせて説明をはじめ、沢山の前提知識を順序だてて提供していくことが必要 #ノンプロ研 #ライティング講座

2023-08-01 20:34:54
hagy4nonpro @hagy4nonpro

初心者向けも案外難しい。 前提情報を順序だてて説明する必要がある。 #ノンプロ研 #ライティング講座

2023-08-01 20:35:43
な~🍀GAS @GasNao703

初心者向けの方が、前提知識がたくさんあるので 初心者向けの方が難しい。 #ノンプロ研 #ライティング講座

2023-08-01 20:35:56
たろ @100Taro

初心者向けは、案外難しい 『前提情報がないため』 #ノンプロ研 #ライティング講座

2023-08-01 20:36:06
Okapie @Okapie4

これは、宿題でLINE Developerコンソールのログインを説明したときに痛感しました。 全部説明せな、となりますね。 #ノンプロ研 #ライティング講座 pic.twitter.com/XUIdBmZHyt

2023-08-01 20:36:36
拡大
な~🍀GAS @GasNao703

VBAは省略してもまーまーうまく動くことが多い。 #ノンプロ研 #ライティング講座 省略形だと伝わらないことも多い pic.twitter.com/R7B67UxUN8

2023-08-01 20:37:13
拡大
拡大
な~🍀GAS @GasNao703

どの知識レベルに向けて書くか? ・初心者向けも難しい ・想定よりも「やや下」を狙うとよい #ノンプロ研 #ライティング講座 自分が困ったときがずいぶん前だと思い出すのが大変。

2023-08-01 20:39:08
hagy4nonpro @hagy4nonpro

前提知識を省略しても良いが、どこで省略した知識を書くか考えておく。 #ノンプロ研 #ライティング講座

2023-08-01 20:39:27
Okapie @Okapie4

いったん省略して先に進んでもOK だが 「省略した知識」の回収の機会をいつ、だれが、どのように設けるのか、も考えてあげないと不親切 (タカハシさんのVBA本はここがスペシャルですよね...) #ノンプロ研 #ライティング講座

2023-08-01 20:39:50
hagy4nonpro @hagy4nonpro

あまり前の事を書くとその時と現在の自分の前提知識に差が出来る。 ちょっと前の自分をターゲットにすると良い。 #ノンプロ研 #ライティング講座

2023-08-01 20:40:46
な~🍀GAS @GasNao703

想定よりも「やや下」とは、 すこしわかりやすく書くと良い #ノンプロ研 #ライティング講座

2023-08-01 20:40:51
Okapie @Okapie4

伝わるかな?という不安がある時は、よりやさしく解説した方が安全安心(ターゲットが離れにくい) #ノンプロ研 #ライティング講座

2023-08-01 20:41:26
hagy4nonpro @hagy4nonpro

初心者向けの書籍が対話形式の体裁を取る事が多いのは、前提知識を自然に説明しやすいためなのかなと思いました。 #ノンプロ研 #ライティング講座

2023-08-01 20:48:06
な~🍀GAS @GasNao703

構造みてないな・・・ #ノンプロ研 #ライティング講座 タイトル勝負・目次みただけで読んだ気になりがちな人

2023-08-01 20:52:21