How to send feedback on a document

ドキュメントへのフィードバック方法
LINE株式会社 Yoshiko Horikoshi

【LINE API総復習シリーズ】Messaging API編【LINE API Expert出演】
https://linedevelopercommunity.connpass.com/event/249965/

Transcript

1. 【LINE API総復習シリーズ】Messaging API編 ドキュメントへのフィードバック⽅法 LINE Corporation Developer Content Team Yoshiko Horikoshi 23rd June 2022 19:00-21:00
2. ⾃⼰紹介
3. はじめまして 「ほりこし」です
4. 2020年1⽉から LINEでテクニカルライター
5. Yoshiko Horikoshi @mochikoAsTech プログラマ（3年） 広報（4年） インフラエンジニア（7年） 2020年1⽉からLINEでテクニカルライター
6. https://techbookfest.org/product/5281591523803136?productVariantID=4639030710894592
8. LINEで テクニカルライター
9. LINE Developersサイト https://developers.line.biz/
14. 私だ︕
15. Developer Content Team
16. ドキュメントは⽇本語と英語で同時公開
17. テクニカルライターの仕事をもっと知りたい⽅は LINEの開発者向けドキュメントを⽀える 「テクニカルライティング」の専⾨チーム というセッションの動画と記事をどうぞ https://www.youtube.com/watch?v=HjKvDK50iY0 https://logmi.jp/tech/articles/325624
18. 今⽇話す内容
19. ドキュメントへの フィードバック⽅法
20. LINE Developersサイト https://developers.line.biz/
21. https://developers.line.biz/ja/about/
22. 「あれ︖この説明、間違ってない︖」 「これじゃわかんないよ︕」 「こう書いてくれたら分かりやすいのに︕」 「この情報、あっちに書いておいてほしかった…」 「このドキュメント、まじで最⾼〜︕」
23. このドキュメントを 書いたやつに ⼀⾔⾔ってやりたい…︕
24. ⾔える場所があります︕
31. フィードバック ちゃんと⾒ています︕
32. どういう意図なんだろう︖ 何に困っているんだろう︖が 分かりにくいフィードバックは 何もできなくて⻭がゆい
33. ドキュメントを読んで使っている みなさんの意⾒を ちゃんと良い形で反映したい
34. フィードバックを書くとき こうしてもらえると嬉しい︕ というポイント2つ
35. ポイント1︓ 背景と要望を 詳しく教えてほしい
36. 悲しい例︓ ◦◦はできますか︖
37. 嬉しい例︓ 「◦◦はできます」という説明を読んで、実際に △△を□□してみましたが、ステータスコード400と 「△△」というエラーメッセージが返ってきて ◦◦はできませんでした。 もし△△を□□した場合は◦◦ができないのであれば、 その説明を追加で書いておいてほしいです。
38. ポイント2︓ ページ内の「どこの部分」の 話か教えてほしい
39. 悲しい例︓ 動かない。
40. 嬉しい例︓ ページ内の「ボタンを作成」セクションで、 ⾃分のLINE公式アカウントを⼊⼒して「友だち追加」ボタンを作り ⾃分のサイトに設置してみましたが、 MacのChromeでサイトにアクセスして、 「友だち追加」ボタンを押しても何も起きなかったです。 iPhoneのSafariで試したときは、ちゃんとLINEアプリが 起動して友だち追加できました。
41. ポイント1︓ 背景と要望を詳しく教えてほしい ポイント2︓ ページ内の「どこの部分」の 話か教えてほしい
43. https://developers.line.biz/ja/faq/#what-is-the-rule-to-count-the-number-of-character
44. https://linecorp.com/ja/career/position/806
45. https://linecorp.com/ja/pr/news/ja/2021/3912
46. https://meety.net/matches/NvKjdEjyOWrl
47. 【LINE API総復習シリーズ】Messaging API編 ドキュメントへのフィードバック⽅法 LINE Corporation Developer Content Team Yoshiko Horikoshi 23rd June 2022 19:00-21:00