Save 37% off PRO during our Black Friday Sale! »

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

いちばん良い一行を見つける近道 / 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/

53850955f15249a1a9dc49df6113e400?s=128

LINE Developers
PRO

April 15, 2021
Tweet

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/

  15. None
  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/