いちばん良い一行を見つける近道 / How to write a better sentence faster

「ここの説明、いまいち分かりにくいから直したいんだけど、どうしようかな」と悩みながら、書き足したり、消したり、少し言い回しを変えたり、前後を入れ替えたり、いやいややっぱりさっきの方がよかったかも、と元に戻したり…いちばん良い一行を探してあーだこーだと長時間悩んでしまった経験はありませんか？いちばん良い一行を見つけるための近道をテクニカルライターが教えます。

■ 発表者
堀越 良子 / LINE株式会社 テクニカルライター。元インフラエンジニア。ねこが好き。
https://twitter.com/mochikoAsTech

■ セッション動画
https://www.youtube.com/watch?v=A8MDWZyusgw&t=2604s

※こちらは以下イベント内で発表した内容です
https://line.connpass.com/event/207045/

Transcript

1. LINE Technical Writing Meetup vol.2 いちばん良い⼀⾏を⾒つける近道 How to write a better sentence faster LINE Corporation Developer Content Team Yoshiko Horikoshi 15th April 2021 19:00-21:00
2. 1: 説明の順番も⼤事な情報 2: いちばん良い⼀⾏を⾒つける近道 3: Questions and Answers 15th April 2021 19:00-21:00 LINE Technical Writing Meetup vol.2
3. ⾃⼰紹介
4. はじめまして 「ほりこし」です
5. LINE Corporation Developer Content Team
6. 2020年1⽉から LINEでテクニカルライター
7. Yoshiko Horikoshi @mochikoAsTech プログラマ（3年） 広報（4年） インフラエンジニア（7年） 2020年1⽉からLINEでテクニカルライター
8. 今⽇話す内容
9. いちばん良い⼀⾏を⾒つける近道
10. 「ここの説明、いまいち分かりにくいから 直したいんだけど、どうしようかな…」 悩みながら、書き⾜したり、消したり、 少し⾔い回しを変えたり、前後を⼊れ替えたり、 いやいややっぱりさっきの⽅がよかったかも、 と元に戻したり…
11. いちばん良い⼀⾏を探して あーだこーだと ⻑時間悩んでしまった︕
12. 「いちばん良い⼀⾏」 を探すときは こういうふうにやるといいよ
13. お題
14. LINE API Status というサイトを オープンした https://api.line-status.info/
16. 開発者が LINE APIの状況を 確認できるサイト
17. LINE API Statusが オープンした︕ めでたい︕
18. LINE APIを使ってる 開発者のみなさんに お知らせしたい︕
19. そうだ、LINE Developersサイトでニュースを出そう︕ https://developers.line.biz/
20. ニュースのタイトルは どうしよう︖
21. 初案︓ 障害状況やステータスを確認できる LINE API Statusを公開しました
22. サイトは⽇本語と英語で同時公開
23. 英訳してみた︓ ⽇︓障害状況やステータスを確認できる LINE API Statusを公開しました 英︓LINE API Status site for checking outage status and status opened
24. 英語だけ直してみた︓ ⽇︓障害状況やステータスを確認できる LINE API Statusを公開しました 英︓LINE API Status site for checking outage status opened
25. レビュー担当のライターから指摘される
26. よし、腰を据えて 良いタイトルを模索しよう︕
27. よりよい⼀⾏を ⾒つける旅に出る…
28. こういうときに やってはいけないこと
29. 初案︓ 障害状況やステータスを確認できる LINE API Statusを公開しました
30. 初案︓ 障害状況やステータスを確認できる LINE API Statusを公開しました
31. 初案︓ 障害やステータスを確認できる LINE API Statusを公開しました
32. 第2案︓ 障害の概要やステータスを確認できる LINE API Statusを公開しました
33. よし、第2案できた︕
34. これ、だめです
35. 初案と第2案の⽐較ができない
36. 初案︓ 障害やステータスを確認できる LINE API Statusを公開しました
37. 第2案︓ 障害の概要やステータスを確認できる LINE API Statusを公開しました
38. あれこれ悩みながら書き⾜したり、 消したり、少し⾔い回しを変えたり、 前後を⼊れ替えたり、いやいや やっぱりさっきの⽅がよかったかも︖
39. え、「さっきの」ってどれだっけ…︖
40. ヒストリーと差分が⾒えないと 善し悪しの⽐較もできない
41. 「いちばん良い⼀⾏」 を探すときは こういうふうにやるといいよ
42. こういうときに お勧めの⽅法
43. コピペしながら全部の案を並べていく （ナンバリングするとなおよし） 1. 障害状況やステータスを確認できるLINE API Statusを公開しました 2. 障害の概要やステータスを確認できるLINE API Statusを公開しました
44. コピペしながら全部の案を並べていく （ナンバリングするとなおよし） • 障害状況やステータスを確認できるLINE API Statusを公開しました • 障害の概要やステータスを確認できるLINE API Statusを公開しました • 障害の概要や安定稼働を確認できるLINE API Statusを公開しました • 安定稼働・障害状況を確認できるLINE API Statusを公開しました • 現在の稼働状況を確認できるLINE API Statusを公開しました • サービスの稼働状況を確認できるLINE API Statusを公開しました • サービスの稼働状況や障害状況を確認できるLINE API Statusを公開しました
45. コピペしながら全部の案を並べていく （ナンバリングするとなおよし） 1. 障害状況やステータスを確認できるLINE API Statusを公開しました 2. 障害の概要やステータスを確認できるLINE API Statusを公開しました 3. 障害の概要や安定稼働を確認できるLINE API Statusを公開しました 4. 安定稼働・障害状況を確認できるLINE API Statusを公開しました 5. 現在の稼働状況を確認できるLINE API Statusを公開しました 6. サービスの稼働状況を確認できるLINE API Statusを公開しました 7. サービスの稼働状況や障害状況を確認できるLINE API Statusを公開しました
46. コピペしながら全部の案を並べていく （ナンバリングするとなおよし） 1. 障害状況やステータスを確認できるLINE API Statusを公開しました 2. 障害の概要やステータスを確認できるLINE API Statusを公開しました 3. 障害の概要や安定稼働を確認できるLINE API Statusを公開しました 4. 安定稼働・障害状況を確認できるLINE API Statusを公開しました 5. 現在の稼働状況を確認できるLINE API Statusを公開しました 6. サービスの稼働状況を確認できるLINE API Statusを公開しました 7. サービスの稼働状況や障害状況を確認できるLINE API Statusを公開しました
47. https://developers.line.biz/ja/news/2021/04/05/line-api-status/
48. まとめ
49. いちばん良い⼀⾏を探すときは 「もとの⼀⾏」に直接⼿を⼊れずに、 コピペしながら全部の案を並べていこう （ナンバリングするとなおよし）
50. いちばん良い⼀⾏を⾒つける近道
51. https://linecorp.com/ja/career/position/806
52. 1: 説明の順番も⼤事な情報 2: いちばん良い⼀⾏を⾒つける近道 3: Questions and Answers 15th April 2021 19:00-21:00 LINE Technical Writing Meetup vol.2
53. このイベントのアーカイブ動画は YouTubeでご覧いただけます https://youtube.com/playlist? list=PL80ip6bOwQsIfO757li02S42XDdWdnmED
54. 次回のMeetupは!春の特別編! 5⽉13⽇(⽊)19:00に開催決定 https://line.connpass.com/