LINE社内テクニカルライティング講座第2弾！1文では説明が終わらない文章を書くコツ

こんにちは、Developer Contentチームの矢崎です。LINE株式会社でテクニカルライターとして働いています。先日、このLINE Engineering Blogで「LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた」というタイトルで、1文を書くときに気をつけていることや手法について紹介しました。 前回の記事を簡単にまとめると「たくさんの文案を書いて、一番良さそうなものを選択することがとても大切です」という話を多くの例文を使って説明しました。まだ読んでいない方はぜひ読んでみてください。 今回の記事は、第2弾です。次のステップとして「1文では説明が終わらない文章をどのように組み立てていくとわかりやすいか」という話を、以下のような文章を例に説明していきます。 ここでは、このくらいの情報量の文章を「トピック」と呼びます。 第2弾を最後まで読む

[trashtoy]

本筋とは関係ないけど, 「こちら」などの文言をハイパーリンクにするのは「Here症候群」と呼ばれるアンチパターン. 自分はあまり好きじゃない

[u_eichi]

この内容だけに、文章自体の冗長さにバツがひとつ。本当にこのレベルの話を理解できていない人にかみ砕いて伝える文章なのか、無自覚な人に構造を解説して再認識を促す文章なのか、筆者が自覚してない所にバツ二つ目

[itokenso]

でもリンクはこちらって書かないとリンクと認識してくれない人がいるから困る

[misarine3]

エンジニアの人が書いた文章って思いつくまま書いてるからわからないドキュメント多いよね。普段からそういうのを書き直してることが多い。まずは自分の書いている文章がわかりづらいものだと認識するところから。

[sudow]

＞ブコメ 誤：エンジニアの人が書いた文章って思いつくまま書いてる→正：人間が書いた文章って思いつくまま書いてる

[BOSEIsan]

“書くときは「思いついた順」「書きやすい順」「伝えたい順」をお勧めします。文章が書きあがるスピードがまったく違うと思います。原稿用紙に書くときはできなかったことですが、いまはみなさんパソコンを使って文

[daysleeeper]

わかったような、わからないような、冗長すぎるような。ブクマ数多いけどそんな広く一般の人の文章術として役立つ内容ではなさそう。あくまでテクニカルライターさん向けだと思う。

[ene0kcal]

このエントリが分かりにくいのはなぜなんだぜぇ？

[ruteinyoyokk121]

自分の文章が分かりづらいのでいろいろ勉強してるけど、自分にとってはこの文章は少し読みづらく感じます。 Webの文章なら見出しで分けて迷子にならないようにしたいです。

[t-ueno]

「1文では説明が終わらない文章を書くコツ」っていうタイトルがおかしくない？って思ったけどまあいいか。

[okawarichang]

あとで読む

[yujiorama]

分かりやすい。最後にまとめを書くと「いかがでしたか」風になりやすい気がするので気をつけよう

[pwtwjmpmgwg]

タイトル、概要、本文について

[Windblume2007]

“「情報の並べかた」”日本語は自然言語なので、どんな順番でも成り立ってしまうからややこしい。形式言語(英語)だと、順番が決まっているからわかりにくい文になりにくい

[nekonyantaro]

文章が長くなる時ほど、相手に「読みたい」「知りたい」と思わせる配慮が重要ということか。

[kabukawa]

第2弾が公開されてる！

[skyfox_xxx]

あとでよむ

[koji28]

LINEだと利用者層がめっちゃ広いから、なおさらこういったライティングが必要になるのかな(´・ω・`)？

[wataken44]

ぞくへんきた

[nanatujima]

「すぐにわかる！」はそんなにいいことか

[fotus4]

タイトル／サマリー／本文の流れ。適切なタイトル、サマリをつけると書き手と読み手の期待ギャップが起こりづらくなる。

[takamii228]

“LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた”

[koreyonda]

https://b.hatena.ne.jp/entry/s/engineering.linecorp.com/ja/blog/line-technical-writing-course/ の続き。タイトル重要、情報の順番重要。

[udonj]

テクニカルライティング