今日から始める技術的負債の解消

Slide 1

Slide 1 text

今日から始める技術的負債の解消レバテック開発部内藤翔太

Slide 2

Slide 2 text

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

|　© 2024 Levtech Co., Ltd. 10 技術的負債を抱えたレガシーコードのリファクタリングで取り除かれた問題の 90％以上が、 ● 命名的問題 ○ メソッド名と実際の関数の動作が一致していない ○ 関数名とコメントが矛盾しているなど ● 構造的問題 ○ 複雑で読みにくい多数の条件分岐や深いネストが存在するなどのいずれかであるという先行研究がある https://smilevo.github.io/self-aﬃrmed-refactoring/Preprint/ESWA20_preprint.pdf 先行研究遡ること 3 ヶ月前...

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

Slide 15

Slide 15 text

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

Slide 22

Slide 22 text

Slide 23

Slide 23 text

Slide 24

Slide 24 text

Slide 25

Slide 25 text

Slide 26

Slide 26 text

Slide 27

Slide 27 text

Slide 28

Slide 28 text

|　© 2024 Levtech Co., Ltd. 28 先日の t-wada さんの Twitter より抜粋コメントの質を上げる書籍「プログラマー脳」によると、プログラミングやドメインへの習熟度によってコードのどこを読むかが異なるということが研究から分かってきている。ドメイン初見の人やプログラミング初心者はコードコメントを読み、熟練者はコードコメントを読まずビーコン(全体の要となる変数名や関数名、それらを合わせた構造等)を読む。なので、「コードコメントを書くべきか、コメント不要なコードを書くべきか」という 2 択ではなく「コメント不要なコードを書いたうえで（これは大前提）、それでもコメントを書くべき（書くことが効果的な）状況は意外と多い」という話なんです。 https://x.com/t_wada/status/1841681739112186228

Slide 29

Slide 29 text

Slide 30

Slide 30 text

Slide 31

Slide 31 text

Slide 32

Slide 32 text

Slide 33

Slide 33 text

|　© 2024 Levtech Co., Ltd. 33 まとめ ● 明らかに命名的問題 > 構造的問題とは言えないが、命名的問題が読解制度に影響を与える以上、軽視しない方が良いことは確か ● まずは動作に影響が出ない(にくい)命名的問題から着手し、構造を把握しやすくした上で構造的問題に着手するのが良いのではないか？ ● 命名的問題には「変数名や関数名」の観点と「コメント」の観点でアプローチする ● コメント不要なコードを書いたうえで（これは大前提）それでもコメントを書くべき（書くことが効果的な）状況は意外と多いので、コメントにも是非とも向き合ってほしい

Slide 34

Slide 34 text

Slide 35

Slide 35 text

宣伝

Slide 36

Slide 36 text

開発職向け会社紹介資料プロダクトや開発組織についてご紹介しています。 https://speakerdeck.com/leverages/levtech-hui-she-shao-jie-zi-liao-enzi niazhi-xiang-ke レバテック開発部テックブログ日々の開発におけるリアルをお届けしています！ https://zenn.dev/p/levtech カジュアル面談フォーム気軽にご応募ください！いろんなお話しましょう！ https://hrmos.co/pages/leverages/jobs/A_c_00071