$30 off During Our Annual Pro Sale. View Details »

writing technical articles as you like

writing technical articles as you like

「技術記事を好き勝手に書くために」
LINE株式会社 uhyo

2022年8月25日開催
今年こそは継続的にアウトプットすると決めた方向けに語る技術発信の取り組み方
https://techplay.jp/event/866808

LINE Developers
PRO

August 25, 2022
Tweet

More Decks by LINE Developers

Other Decks in Technology

Transcript

  1. ٕज़هࣄΛ ޷͖উखʹॻͨ͘Ίʹ  ࠓ೥ͦ͜͸ܧଓతʹΞ΢τϓοτ͢ΔͱܾΊͨํ޲͚ʹޠΔٕज़ൃ৴ͷऔΓ૊Έํ VIZP

  2. About Speaker VIZP –-*/&ͷϑϩϯτΤϯυΤϯδχΞ –5ZQF4DSJQUͱ3FBDU͕ઐ໳ –5ZQF4DSJQUೖ໳ॻ ޷ධൃചதʂ

  3. This Talk –ٕज़هࣄΛॻ͘ͱԿ͕͍͍ͷʁ –ٕज़هࣄͷਖ਼͠͞ʹ஫ҙ͠Α͏ –ٕज़هࣄॻ͖ͷεςοϓΞοϓγφϦΦ

  4. uhyoと技術記事 ೥ࠒ͔Βٕज़هࣄΛॻ͖࢝Ίͨ ౰࣌͸λΠτϧͰἤΔهࣄ͕ྲྀߦ͍ͬͯͨ λΠτϧͰἤͬͯΔͷʹ಺༰͕༗ӹͩͬͨΒ ΢έΔͷͰ͸ʁ ͱࢥ͍هࣄΛॻ͖࢝Ίͨ ˞ʮड༰͞ΕΔʯͰ͸ͳ͘ʮͪΐʔ΢έΔΜͰ͚͢Ͳʯͷํ

  5. ウケる記事の例 5ZQF4DSJQUͷܕೖ໳ 2JJUB  ΢έϙΠϯτɿ ʮೖ໳ʯͳͷʹ͋ΒΏΔܕΛ໢ཏ͍ͯ͠Δ

  6. 技術記事を書くと何がいいのか 書き⼿ 記事 コミュニティ 記事を通して価値を提供できる 記事を書くと勉強になる (資料を⾒直す、整理するなど)

  7. 技術記事を書くと何がいいのか 書き⼿ フィードバックをもらえる 読み⼿ コミュニティ 価値を提供すれば 知名度・信頼が得られる

  8. 技術記事を書くと何がいいのか ·ͱΊΔͱ –ίϛϡχςΟʹߩݙͰ͖Δʂ –पΓ͔ΒͷධՁ্͕͕Δʂ –ษڧʹͳΔʂ

  9. 技術記事の正しさについて 2ؒҧͬͨ಺༰Λॻ͘ͱୟ͔Εͦ͏ʜʜ

  10. 技術記事の正しさについて 2ؒҧͬͨ಺༰Λॻ͘ͱୟ͔Εͦ͏ʜʜ "ͦΕ͸ͦ͏

  11. 技術記事の正しさについて コミュニティ 公式ドキュメントと 同じ情報の記事 公式ドキュメントに付加価値を 加えた記事 (追加情報, 翻訳, . わかりやすさ

    etc) 間違った内容の記事 正の価値 ±0 負の価値
  12. 技術記事の正しさについて 間違った内容の記事 こんな間違った記事を書くなんて こいつはクズだ! こんな間違った記事を書くなんて 迷惑だ! (実際迷惑なので仕⽅ない) ⼈格攻撃は だめだよの盾

  13. 技術記事の正しさについて ؒҧͬͨ಺༰ͷهࣄ͸ίϛϡχςΟʹෛͷՁ஋Λ༩͑ͯ ͠·͏ͷͰɺୟ͔ΕΔͷ͸࢓ํ͕ͳ͍ɻ ؒҧͬͨ಺༰ͷهࣄΛగਖ਼͢Δ͜ͱ΋ɺίϛϡχςΟ΁ͷ Ձ஋ఏڙͷ؍఺Ͱ͸ྑ͍هࣄΛॻ͘ͷͱಉ͘͡Β͍ॏཁɻ

  14. 初⼼者向けの記事執筆戦略 2Ͱ΋ॳ৺ऀ͔ͩΒίϛϡχςΟʹਖ਼ͷՁ஋Λ༩͑Δهࣄ ͳΜͯॻ͚ͳ͍ʜʜ

  15. 初⼼者向けの記事執筆戦略 2Ͱ΋ॳ৺ऀ͔ͩΒίϛϡχςΟʹਖ਼ͷՁ஋Λ༩͑Δهࣄ ͳΜͯॻ͚ͳ͍ʜʜ " ͜͜͸ఘΊͯͬͪ͜ʹूத͠Α͏ 書き⼿ 記事 コミュニティ

  16. 初⼼者向けの記事執筆戦略 ίϛϡχςΟʹਖ਼ͷՁ஋Λ༩͑Δ͜ͱ͸೉͍͠ɻ ࠷ॳ͸œΛ໨ࢦͯ͠ɺࣗ෼ͷ੒௕΍ϑΟʔυόοΫΛૂͬͯ هࣄΛॻ͜͏ɻ ੒௕ͨ͠Βಘҙ෼໺ͰՁ஋ͷ૑ग़ΛࢼΈΑ͏ɻ ʢެࣜυΩϡϝϯτͱඃͬͯΔ಺༰Λॻ͘͜ͱ͸Ձ஋ͷ૑ग़ʹ͸ͳΒͳ͍͕ɺ ࣗ෼ͷཧղ౓ΛपΓʹΞϐʔϧ͢ΔࡐྉʹͳΔ͔΋ʣ

  17. 初⼼者向けの記事執筆戦略 2Ͱ΋ॳ৺ऀ͔ͩΒؒҧ͍Λॻ͍ͪΌ͏͔΋͠Εͳ͍͠ɺ ୟ͔ΕΔͷ͸ා͍ʜʜ

  18. 初⼼者向けの記事執筆戦略 2Ͱ΋ॳ৺ऀ͔ͩΒؒҧ͍Λॻ͍ͪΌ͏͔΋͠Εͳ͍͠ɺ ୟ͔ΕΔͷ͸ා͍ʜʜ "લͷηογϣϯΛࢀߟʹؒҧ͍Λ๷͝͏ɻ ͋ͱ͸๷ޚढจΛ֮͑Α͏

  19. 初⼼者向けの防御呪⽂ ʮҎԼͷ಺༰ʹ͸ޡΓؚ͕·ΕΔՄೳੑ͕͋Γ·͢ʯ –هࣄͷ๯಄Ͱ࢖༻ɻࣗ෼͕ॳ৺ऀͰ͋Δ͜ͱΛ໌͔͠ɺ ಡΉਓʹ஫ҙΛଅ͢ ˠ಺༰͕ؒҧ͍ͬͯͯ΋໎࿭Ͱ͸ͳ͘ͳΔ ʮͱࢥ͍·͢ʯ –Ͳ͜Ͱ΋࢖͑Δ൚༻ੑͷߴ͍ढจɻͦͷ෦෼͕ࣄ࣮Ͱ͸ ͳ͘ਪଌ΍ҙݟͰ͋Δ͜ͱΛࣔ͢

  20. 初⼼者向けの防御呪⽂ ๷ޚढจΛ࢖ͬͯهࣄͷਖ਼͠͞Λ୲อ͠Α͏ɻ ʮͱࢥ͍·͢ʯͳͲͷ๷ޚʹΑΓɺؒҧͬͨهड़΋ਖ਼͍͠ هड़ʹม׵Ͱ͖Δɻ こんな間違った記事を書くなんて 迷惑だ! 正しさの盾

  21. 初⼼者向けの防御呪⽂ ਖ਼͠͞Λલఏʹ͢Δ͜ͱͰɺετϨεϑϦʔͳϑΟʔυ όοΫΛड͚ΒΕΔɻ こんな間違った記事を書くなんて 迷惑だ! 正しさの盾 Xと思われたようですが、Yではないでしょうか? (⾮攻撃的なアドバイス)

  22. uhyoが記事執筆時に気をつけていること ͱʹ͔͘ਖ਼͠͞ʹؾΛ͚͍ͭͯ·͢ɻ৘ใͷਖ਼͚ͩ͠͞ Ͱͳ͘ɺ࿦ཧతਪ࿦ͷਖ਼͠͞΋ॏཁɻ – ਖ਼͍͠಺༰ͷهࣄ͸ࣗ਎ʹର͢Δ৴པʹͭͳ͕Δɻ – ࣄ࣮Λ౿·͑ͯҙݟΛड़΂Δࡍ͸ɺࣄ࣮ɾ࿦ཧ͕ਖ਼͘͠ͳ͍ͱҙຯΛ੒͞ͳ͍ɻ ٯʹݴ͑͹ɺਖ਼͑͠͞͞୲อ͢Ε͹จ۟ΛݴΘΕΔے߹͍͕ ͳ͍ͷͰ޷͖উखʹॻ͍͍͍ͯʂ

  23. uhyoが記事執筆時に気をつけていること هࣄͷલఏΛॻ͘͜ͱ΋ॏཁɻ –࿦ཧల։͕ਖ਼ͯ͘͠΋ɺલఏ͕ҟͳΔਓ͸ೲಘ͠ͳ͍ɻ ྫʮྑ͍ίʔυͷॻ͖ํʯʹ͍ͭͯ࿦ཧతʹٞ࿦Λల։ͯ͠΋ɺ ͦ΋ͦ΋ʮྑ͍ίʔυʯͷఆ͕ٛҟͳΔਓʹ͸ڹ͔ͳ͍ɻ この記事は俺の考えと違う! 間違いだ! 前提が違うだけ でしょの盾

  24. 技術記事書きのステップアップシナリオ 2݁ہॳ৺ऀ͕ٕज़هࣄॻ͖ͱͯ͠εςοϓΞοϓ͢Δʹ͸ Ͳ͏͢Ε͹͍͍ͷʁ

  25. 技術記事書きのステップアップシナリオ 2݁ہॳ৺ऀ͕ٕज़هࣄॻ͖ͱͯ͠εςοϓΞοϓ͢Δʹ͸ Ͳ͏͢Ε͹͍͍ͷʁ " ࣍ͷεςοϓ͕͓͢͢Ί  ࿅शظ  ৴པ޲্ظ 

    ࢥ૝ൃ৴ظ
  26. 1. 練習期 ແཧͯ͠ਖ਼ͷՁ஋ΛίϛϡχςΟʹఏڙ͠Α͏ͱͤͣʹɺ هࣄࣥචͷ࿅शͱࣗ਎ͷٕज़ྗ޲্ʹ౒ΊΔɻ ๷ޚढจΛۦ࢖ͯ͠਎ΛकΓͳ͕ΒهࣄΛॻ͘ɻ ৴པͰ͖Δਓ΍ɺ௨Γ͕͔Γͷਓ͔ΒϑΟʔυόοΫΛ ΋Βͬͯ஌ࣝΛ޲্Ͱ͖Δͱ٢ɻ

  27. 1. 練習期 〜 2. 信頼向上期 ಘҙ෼໺Λݟ͚ͭͯɺ๷ޚढจʹཔΒͣʹਖ਼͠͞Λ୲อ Ͱ͖ΔΑ͏ʹͳΖ͏ɻ ׳Ε͖ͯͨΒɺهࣄʹ৽نੑΛಋೖͯ͠ਖ਼ͷՁ஋Λ ίϛϡχςΟʹఏڙͯ͠ΈΑ͏ɻ ৽نੑͷಋೖ͸೉қ౓͕ߴ͍͕ɺࣗ਎ͷ੒௕ʹ΋ܨ͕Δɻ

    ਖ਼͍͠৘ใΛൃ৴ͯࣗ͠਎ͷ৴པΛஷΊΑ͏ɻ
  28. 2. 信頼向上期 ৽نੑͷྫ –Θ͔Γ΍͢͞Λ௥ٻ͢Δʢॳ৺ऀ໨ઢͱ͔ʣ –ࠓ͙͢͸࢖͑ͳ͍͕কདྷ໾ཱͭ࠷৽৘ใΛఏڙ͢Δ –ϚχΞοΫͳ৘ใΛఏڙ͢ΔʢಛఆͷΤϥʔϝοηʔδʹಛԽͨ͠ ৘ใͱ͔ʣ –·ͩ೔ຊޠʹͳ͍ͬͯͳ͍৘ใΛ຋༁͢Δ

  29. 信頼向上期で発⽣する問題 ্ڃऀ͸஌ࣝΛ͢Ͱʹ͍࣋ͬͯΔͷͰɺ ஌͚ࣝͩΛఏڙͯ͠΋ڹ͔ͳ͍ɻ ্ڃऀΛײ৺ͤ͞Δʹ͸஌ݟɾߟ࡯ɾࢥ૝ͳͲɺ ୯ͳΔࣄ࣮Λ௒͑Δ಺༰͕ඞཁɻ

  30. 3. 思想発信期 ࣗ෼ͷࢥ૝Λ࣋ͪͦΕΛ޿ΊΑ͏ɻ ͦΕ·Ͱʹ৴པΛஷΊ͍ͯΕ͹ࢥ૝ʹڞײͯ͠ ΋Β͍΍͍͢ɻ ΋ͪΖΜɺਓΛೲಘͤ͞ΒΕΔ಺༰͕ඞཁɻ લఏΛఆΊɺ͜Ε·ͰͷܦݧΛ׆͔ͯ͠ਖ਼͍͠࿦ཧల։Ͱ ݁࿦Λಋ͜͏ɻ

  31. 3. 思想発信期 ࣗ෼ͷࢥ૝ʢͱ͍ͬͯ΋ͪΌΜͱ࿦ཧతʹߟ͑ͨ಺༰ʣ Λൃ৴ͯͦ͠Ε͕ೝΊΒΕΔΑ͏ʹͳΔͱɺ ͔ͳΓ޷͖উखײ͕૿͠·͢ɻ Ӷ͍ߟ࡯Ͱ্ڃऀΛᄬΒͤɺք۾΁ͷӨڹྗ޲্Λ໨ࢦ͢ͱ ͍͍͔΋͠Ε·ͤΜʢ໨ࢦ͍ͨ͠ʣ

  32. まとめ ٕज़هࣄΛ޷͖উखʹॻͨ͘Ίʹ͸ͱʹ͔͘ਖ਼͕͠͞ॏཁɻ ॳ৺ऀͷ͏ͪ͸ࣗ෼ΛकΔ६ͱͳΓɺ੒௕ͯ͘͠Δͱ৴པͱ ೲಘΛಘΔͨΊͷ݋ͱͳΔɻ ୯ͳΔ৘ใͰ͸ͳ͘ࢥ૝Λൃ৴Ͱ͖ΔΑ͏ʹͳΔͱ্ڃऀͷ ஥ؒೖΓɻ

  33. まとめ ͩͱࢥ͍·͢ɻ ͓ΘΓ このスライドで使⽤されている絵⽂字は Twemoji (https://twemoji.twitter.com/) またはそれを加⼯したものです。