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

コミュニティ「ノンプログラマーのためのスキルアップ研究会」の技術ライティング講座 第5回のツイートまとめです。 第5回のテーマは「文章を書く技術1」です!
2
前へ 1 2 ・・ 5 次へ
etau @etau0422

聞くのがメインの講座は、集中が途切れがちなので、モニタの数を減らして臨んでるよ。 #ノンプロ研 #技術ライティング講座

2021-02-15 20:25:09
もり@テックライター📙 @moripro3

目標を下げず、速く目標達成してもらう文章を書くには? ・これまで知られてない方法を発見して書く ・ターゲットを絞って、ベストな文章を書く #ノンプロ研

2021-02-15 20:26:58
etau @etau0422

ターゲットに依存しないいい文章の書き方とかすごいね。 #ノンプロ研 #技術ライティング講座

2021-02-15 20:27:54
くのへ@テクニカルクリエイター(OutlookVBA、VR、3Dモデリング) @MasazaneKunohe

#ノンプロ研 読みやすい文章の書き方のお作法 分かってはいるつもり。 でもそれが「早く」書けない私。

2021-02-15 20:28:04
大山湧位置(ビッグサン) @bigsan33

「これまで知られてない方法を発見して書く」 すでに誰かが書いてるなら、それを紹介するだけでいいからね。 少しでも自分のエッセンスがないと。 #技術ライティング講座 #ノンプロ研 pic.twitter.com/LuQ9YPIkAM

2021-02-15 20:29:03
拡大
etau @etau0422

『みなさんプログラミングも好きだと思いますんで』大好きです! #ノンプロ研 #技術ライティング講座

2021-02-15 20:30:45
etau @etau0422

参考図書は、まさかの「リーダブルコード」!だから、俺向け? #ノンプロ研 #技術ライティング講座

2021-02-15 20:31:13
もり@テックライター📙 @moripro3

【リーダブルな文章を書く作法を知る】 「きまったやり方」や「しきたり」は、書くための選択肢を減らすテクニックでもあります あらかじめルールが決まっていると、悩む回数も減りますよね #ノンプロ研

2021-02-15 20:31:20
🍊 @ponponmikankan

すみません今仕事おわった。追いつきます。 #ノンプロ研

2021-02-15 20:32:49
etau @etau0422

なるほど、かっこいいコードが書ける俺には、かっこいい文章がかけるっていうことだな、たぶん。 #ノンプロ研 #技術ライティング講座

2021-02-15 20:33:15
もり@テックライター📙 @moripro3

【リーダブルに書くための作法①】 1.一度に一つのことを ・ひとつの要素に2つ以上を混在させない (文、段落、項、節、章、部) ・次の要素の前に、回収して結論づける ・混在している場合は、分割する →「回収して結論づける」とわかりやすくなりますね #ノンプロ研

2021-02-15 20:34:52
kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

おしゃべり得意じゃないんだけど、次々つながった文章になりがち。 なんでだ? #ノンプロ研

2021-02-15 20:38:13
ume @plumfield56

文章もコードも同じで、1文で複数のことを書いていると読みづらい。 言われたらわかるけど普段意識してないな。 コードもメソッドつなげて一気に書くの好きだな… #ノンプロ研

2021-02-15 20:38:40
@shotarosawada

技術ライティング講座では「読みやすさ」にフォーカスしてそのための作法をみていく。読みやすくするために、まず、短く分ける。一度にひとつのことを論じる。#ノンプロ研

2021-02-15 20:39:38
もり@テックライター📙 @moripro3

【リーダブルに書くための作法②】 2.明確にする ・主語と述語の関係を明確に ・指示語(こそあど言葉)を使いすぎない ・二重否定を避ける ・逆説ではない「~が」を避ける ・受動態を避ける ・メタ情報(情報を説明するための情報)を付与する #ノンプロ研

2021-02-15 20:39:53
もり@テックライター📙 @moripro3

#ノンプロ研 らしく、ソースコードを見ながら具体例を確認しています。 「二重否定を避ける」の具体例 ↓ ①If Not IsRed <> True Then ②If IsRed Then →②の方がわかりやすいですね

2021-02-15 20:41:36
etau @etau0422

この正式な言葉を使うってのは、講座やってるとめっちゃ気をつかうやつや。 #ノンプロ研 #技術ライティング講座

2021-02-15 20:41:45
saitoosamu @saitoosamu

明確にする ややこしく欠かない 肯定文で書く シンプルに書く ただし省略しすぎない 読み手の負担に配慮する #ノンプロ研

2021-02-15 20:42:03
🍊 @ponponmikankan

一度に一つ以上の要素をいれない #ノンプロ研

2021-02-15 20:42:19
HiroCom777 @Hirocom7772

情報を説明するための情報 メタ情報 #ノンプロ研

2021-02-15 20:43:04
@shotarosawada

ある情報を差し出すときに、その意味をより高い視点から説明する「メタ情報」を付与する。 #ノンプロ研

2021-02-15 20:45:24
前へ 1 2 ・・ 5 次へ