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

「コード品質向上のテクニック」連載継続の秘訣

 「コード品質向上のテクニック」連載継続の秘訣

Technical Writing Meetup vol.41 での登壇資料です。
セッション概要: LINEヤフー Tech Blog では「コード品質向上のテクニック」という連載を、一年以上にわたってほぼ毎週公開しています。しかし、このようにアウトプットを継続するには、少なからぬ時間や根気が必要です。本セッションでは、なぜ連載を続けられているのか、その秘訣をご紹介します。

More Decks by LINEヤフーTech (LY Corporation Tech)

Other Decks in Technology

Transcript

  1. -*/&$MJFOU෦ॺͷίʔυ඼࣭޲্ͷऔΓ૊Έ  .FSHFࡁΈͷίʔυΛ࠶౓ϨϏϡʔ  ӳޠͷϨϙʔτΛ෦ॺͰڞ༗ ຖि 3FWJFX$PNNJUUFFͷ׆ಈ Development team merge

    request review Codebase Review committee review feedback discussion “Twemoji” © Twitter, Inc and other contributors (Licensed under CC BY 4.0) https://twemoji.twitter.com/ report
  2. ࿩͢͜ͱʹΑΔվળ఺ͷൃݟ  ΑΓೲಘ͠΍͍͢ετʔϦʔ  ิ଍͢Δ΂͖આ໌ ෦ॺ಺ͱ͍͏҆৺ײDPOU A ͱ B ͕୅දྫͰ͢

    ͋ͱ C ΋ॏཁͳྫͰ͢Ͷ ͋ͱͰ C Λิ଍͓ͯ͜͠͏ 
 Report Foo
 
 ୅දྫ
 A: ...
 B: ... “Twemoji” © Twitter, Inc and other contributors (Licensed under CC BY 4.0) https://twemoji.twitter.com/
  3. ʮΞώϧͪΌΜʯʹ࿩ͯ͠໰୊Λ੔ཧ͢Δख๏  ݩདྷ͸σόοάͷख๏  5IF1SBHNBUJD1SPHSBNNFSͰ঺հ ࿩͢͜ͱͰࢥߟΛ੔ཧଞਓΛ൥Θͤͳ͍ 3VCCFS%VDLJOH “A rubber duck

    assisting with debugging some Java code in NetBeans.”
 © Tom Morris (Licensed under CC BY-SA 3.0)
 https://commons.wikimedia.org/wiki/File:Rubber_duck_assisting_with_debugging.jpg
  4. ֤ஈ֊Ͱͷʮ࠷௿ϥΠϯʯΛ௿Ίʹઃఆ ແཧͷͳ͍ࠩ෼ Slack ͷ
 ϝϞ ෦ॺ಺
 Ϩϙʔτ ࣾ಺
 Ϩϙʔτ ϒϩάهࣄ

    ࿩ͤ͹఻ΘΔ ೔ຊޠʹͳ͍ͬͯΔ ࣄ࣮ & ଥ౰Ͱ͋Δ ࠷௿ϥΠϯ Nice to Have ಡΈ΍͍͢
 ߏ੒/จষʹͳ͍ͬͯΔ Ϩϙʔτ͚ͩͰ
 ҙຯ͕෼͔Δ ؒҧ͍͕
 मਖ਼͞Ε͍ͯΔ ֤ஈ֊͕ʮͱΓ͋͑ͣʯ׬ྃͰ͖ΔΑ͏ʹ͢Δ
  5. ֤ஈ֊Ͱωλ΍ૉࡐΛͨΊ͓ͯ͘ ஈ֊͝ͱͷόοϑΝ Slack ͷ
 ϝϞ ෦ॺ಺
 Ϩϙʔτ ࣾ಺
 Ϩϙʔτ ϒϩάهࣄ

    1 ~ 3 िؒ෼ 1 ~ 3 िؒ෼ 5 िؒ෼ ωλͷݸ਺ ෦ॺ಺ࣾ಺ڞ༗͕Ωϟϯηϧ͞Εͯ΋ϒϩάެ։ΛܧଓՄೳ
  6. Ξ΢τϓοτͷൣғͱϑΥʔϚϧ͞ ൣғ ޿ ൣғ ڱ Ұൠެ։ ݸਓ Ո଒ ༑ਓ ٕज़ίϛϡχςΟ

    νʔϜ ࣾ಺ ϑΥʔϚϧ ΧδϡΞϧ ঎ۀग़൛ ͭͿ΍͖ ࡶஊ ϝϞॻ͖ ϓϨθϯςʔγϣϯ Ϩϙʔτ ϛʔςΟϯά ϒϩάهࣄ SNS ϙετ
  7. ग़ൃ఺͸ʮಉ͡આ໌Λ܁Γฦ͢ͷ͸େมʯ  ίʔυϨϏϡʔ࣌ͷޱ಄આ໌  ͘͝ڱ͍ൣғͰͷϓϨθϯςʔγϣϯ  ଞ෦ॺ΍ւ֎ڌ఺΁ͷϓϨθϯςʔγϣϯ  ࣾ಺ެࣜͷڭҭࢿྉҰൠެ։ॻ੶ࣥච <έʔεελσΟ>ಡΈ΍͍͢ίʔυͷΨΠυϥΠϯ

    Prisoner's dilemma Team productivity may decrease if we focus on the personal Eng. A ┃ │ ┃ Write clean code │ Write hacky code Eng. B ┃ │ ━━━━━━━━━━━━━━━━━━╋━━━━━━━━━━━━━━━━━━┿━━━━━━━━━━━━━━━━━━━ ┃ 8 │ 10 Write clean code ┃ │ ┃ 8 │ 1 ──────────────────╂──────────────────┼─────────────────── ┃ 1 │ 2 Write hacky code ┃ │ ┃ 10 │ 2 Introduction and Principles > Introduction Prisoner's dilemma Team productivity may decrease if we focus on the personal productivity Bob Alice Hacky Readable Readable Hacky 8 8 10 1 1 10 2 2 Introduction and Principles > Introduction