Slide 1

Slide 1 text

【LINE API総復習シリーズ】Messaging API編 ドキュメントへのフィードバック⽅法 LINE Corporation Developer Content Team Yoshiko Horikoshi 23rd June 2022 19:00-21:00

Slide 2

Slide 2 text

⾃⼰紹介

Slide 3

Slide 3 text

はじめまして 「ほりこし」です

Slide 4

Slide 4 text

2020年1⽉から LINEでテクニカルライター

Slide 5

Slide 5 text

Yoshiko Horikoshi @mochikoAsTech プログラマ(3年) 広報(4年) インフラエンジニア(7年) 2020年1⽉からLINEでテクニカルライター

Slide 6

Slide 6 text

https://techbookfest.org/product/5281591523803136?productVariantID=4639030710894592

Slide 7

Slide 7 text

No content

Slide 8

Slide 8 text

LINEで テクニカルライター

Slide 9

Slide 9 text

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

Slide 10

Slide 10 text

No content

Slide 11

Slide 11 text

No content

Slide 12

Slide 12 text

No content

Slide 13

Slide 13 text

No content

Slide 14

Slide 14 text

私だ︕

Slide 15

Slide 15 text

Developer Content Team

Slide 16

Slide 16 text

ドキュメントは⽇本語と英語で同時公開

Slide 17

Slide 17 text

テクニカルライターの仕事をもっと知りたい⽅は LINEの開発者向けドキュメントを⽀える 「テクニカルライティング」の専⾨チーム というセッションの動画と記事をどうぞ https://www.youtube.com/watch?v=HjKvDK50iY0 https://logmi.jp/tech/articles/325624

Slide 18

Slide 18 text

今⽇話す内容

Slide 19

Slide 19 text

ドキュメントへの フィードバック⽅法

Slide 20

Slide 20 text

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

Slide 21

Slide 21 text

https://developers.line.biz/ja/about/

Slide 22

Slide 22 text

「あれ︖この説明、間違ってない︖」 「これじゃわかんないよ︕」 「こう書いてくれたら分かりやすいのに︕」 「この情報、あっちに書いておいてほしかった…」 「このドキュメント、まじで最⾼〜︕」

Slide 23

Slide 23 text

このドキュメントを 書いたやつに ⼀⾔⾔ってやりたい…︕

Slide 24

Slide 24 text

⾔える場所があります︕

Slide 25

Slide 25 text

No content

Slide 26

Slide 26 text

No content

Slide 27

Slide 27 text

No content

Slide 28

Slide 28 text

No content

Slide 29

Slide 29 text

No content

Slide 30

Slide 30 text

No content

Slide 31

Slide 31 text

フィードバック ちゃんと⾒ています︕

Slide 32

Slide 32 text

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

Slide 33

Slide 33 text

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

Slide 34

Slide 34 text

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

Slide 35

Slide 35 text

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

Slide 36

Slide 36 text

悲しい例︓ ○○はできますか︖

Slide 37

Slide 37 text

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

Slide 38

Slide 38 text

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

Slide 39

Slide 39 text

悲しい例︓ 動かない。

Slide 40

Slide 40 text

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

Slide 41

Slide 41 text

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

Slide 42

Slide 42 text

No content

Slide 43

Slide 43 text

https://developers.line.biz/ja/faq/#what-is-the-rule-to-count-the-number-of-character

Slide 44

Slide 44 text

https://linecorp.com/ja/career/position/806

Slide 45

Slide 45 text

https://linecorp.com/ja/pr/news/ja/2021/3912

Slide 46

Slide 46 text

https://meety.net/matches/NvKjdEjyOWrl

Slide 47

Slide 47 text

【LINE API総復習シリーズ】Messaging API編 ドキュメントへのフィードバック⽅法 LINE Corporation Developer Content Team Yoshiko Horikoshi 23rd June 2022 19:00-21:00