Upgrade to Pro — share decks privately, control downloads, hide ads and more …

How to send feedback on a document

How to send feedback on a document

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

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

A3966f193f4bef226a0d3e3c1f728d7f?s=128

LINE Developers
PRO

June 23, 2022
Tweet

More Decks by LINE Developers

Other Decks in Technology

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

  7. None
  8. LINEで テクニカルライター

  9. LINE Developersサイト https://developers.line.biz/

  10. None
  11. None
  12. None
  13. None
  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. ⾔える場所があります︕

  25. None
  26. None
  27. None
  28. None
  29. None
  30. None
  31. フィードバック ちゃんと⾒ています︕

  32. どういう意図なんだろう︖ 何に困っているんだろう︖が 分かりにくいフィードバックは 何もできなくて⻭がゆい

  33. ドキュメントを読んで使っている みなさんの意⾒を ちゃんと良い形で反映したい

  34. フィードバックを書くとき こうしてもらえると嬉しい︕ というポイント2つ

  35. ポイント1︓ 背景と要望を 詳しく教えてほしい

  36. 悲しい例︓ ◦◦はできますか︖

  37. 嬉しい例︓ 「◦◦はできます」という説明を読んで、実際に △△を□□してみましたが、ステータスコード400と 「△△」というエラーメッセージが返ってきて ◦◦はできませんでした。 もし△△を□□した場合は◦◦ができないのであれば、 その説明を追加で書いておいてほしいです。

  38. ポイント2︓ ページ内の「どこの部分」の 話か教えてほしい

  39. 悲しい例︓ 動かない。

  40. 嬉しい例︓ ページ内の「ボタンを作成」セクションで、 ⾃分のLINE公式アカウントを⼊⼒して「友だち追加」ボタンを作り ⾃分のサイトに設置してみましたが、 MacのChromeでサイトにアクセスして、 「友だち追加」ボタンを押しても何も起きなかったです。 iPhoneのSafariで試したときは、ちゃんとLINEアプリが 起動して友だち追加できました。

  41. ポイント1︓ 背景と要望を詳しく教えてほしい ポイント2︓ ページ内の「どこの部分」の 話か教えてほしい

  42. None
  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