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

意外と大事! DevRelに使える日本語テクニック

意外と大事! DevRelに使える日本語テクニック

「見た目より中身だよ!」とか「いいもの作れば売れるんだよ!」とか。

それが幻想だというのは、大人となってさまざまな経験を積んできた皆さんならお分かりですね。いかに製品・サービスとユーザーやユーザー候補との距離を縮めるか。これがDevRelやアドボケイトの肝心要の役割ではないですか。

コーディングは学ばないと厳しいけど、日本語は日本で育ってきたら普段気にせずに使うので別に学ばなくても書けます。とはいえ適切に書けているかどうかは別。製品・サービスにドキュメントは必須だし役に立つはずですが、ユーザーは困ったときに公式ドキュメントに頼らず(頼れず?)、Qiitaとかの情報投稿サイトに頼るのはなぜでしょう。

その原因の、たとえば、

- 誤解される文章(まずそれはNG!)
- 分かりにくい文章(だからドキュメント離れが……)
- 冗長な文章(ワーキング メモリーを無駄に使ってしまう)

などについて、具体的な例を挙げながら解説します。

本セッションでは、「今日から使える!」分かりやすい日本語を書くポイントをシェアします。

2023年3月10日・11日@横浜
DevRel/Japan CONFERENCE 2023 にて登壇

https://devrel.tokyo/japan-2023/

wataru yamazaki (DevRel)

March 10, 2023
Tweet

More Decks by wataru yamazaki (DevRel)

Other Decks in Marketing & SEO

Transcript

  1. ׽ࣈͱͻΒ͕ͳͷ࢖͍෼͚ ಡΈ΍͢͞Λ ߟྀ͢Δ ྫʣ • $-*Λ࢖༻͢Δ࣌͸ʙ ˠ $-*Λ࢖༻͢Δͱ͖͸ʙ • ༷ʑͳཧ༝͔Βʙ

    ˠ ͞·͟·ͳཧ༝͔Βʙ • ྫ͑͹ɺ.BDͷ৔߹ʙ ˠ ͨͱ͑͹ɺ.BDͷ৔߹ʙ • ʙ͢Δࣄ͸ ʙ ˠ ʙ͢Δ͜ͱ͸ʙ • 'Λԡͯ͠Լ͍͞ ˠ'Λԡ͍ͯͩ͘͠͞ • ໰͍߹Θͤ௖͖ʙ ˠ໰͍߹Θ͍͖ͤͨͩʙ
  2. $IBU(15ʹ΋ฉ͍ͯΈ·ͨ͠ ҎԼʹɺߨԋςʔϚʮ೔ຊޠͷٕज़จষΛ࡞੒͢ΔࡍʹؾΛ෇͚ΔϙΠϯτͱɺ೔ຊޠΛϨϕ ϧΞοϓ͢Δ؆୯ͳςΫχοΫʯʹ͓͍ͯɺ࿩͢΂͖ϙΠϯτΛͭʹ·ͱΊ·ͨ͠ɻ  ೔ຊޠͷจ๏ɾදݱͷಛ௃ • ओޠɾड़ޠɾ໨తޠͷॱং͕ҟͳΔ͜ͱʹΑΔจষߏ଄ͷಛ௃ • จࣈ਺͕গͳͯ͘ࡁΉলུදݱͷ࢖͍ํ •

    ༷ʑͳܟޠͷ࢖͍෼͚ͱͦͷద੾ͳ࢖͍ํ  ೔ຊޠʹ͓͚Δద੾ͳઐ໳༻ޠͷ࢖͍ํ • ٕज़෼໺ʹ͓͍ͯҰൠతʹ࢖ΘΕΔઐ໳༻ޠͷ೺Ѳ • ೔ຊޠͰಠࣗʹ࡞ΒΕͨઐ໳༻ޠͷཧղ • ઐ໳༻ޠͷχϡΞϯεʹ͍ͭͯͷೝࣝ  ೔ຊޠͷදݱͷ໌֬Խͱద੾ͳදݱํ๏ • ಺༰Λ୺తʹ఻͑ΔͨΊͷγϯϓϧͳදݱํ๏ • ׽ࣈͷ࢖͍ํʹΑΔಡΈ΍͢͞ͷ޲্ • ద੾ͳ۟ಡ఺ͷ࢖͍ํʹΑΔಡΈ΍͢͞ͷ޲্ ͜ΕΒͭͷϙΠϯτ͸ɺ೔ຊޠͷٕज़จষ࡞੒ʹ͓͍ͯॏཁͳཁૉΛΧόʔ͓ͯ͠Γɺௌऺ ʹͱ࣮ͬͯફతͳՁ஋ͷ͋Δ಺༰ͱͳΔͱߟ͑ΒΕ·͢ɻ