Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
コメントアウトするべきでは「ない」こと
Search
ミカイ
April 02, 2024
0
14
コメントアウトするべきでは「ない」こと
ミカイ
April 02, 2024
Tweet
Share
More Decks by ミカイ
See All by ミカイ
フリーランスになる前にやるべきこと ランキング1位が 意外だった件
junmikai
0
2
作りたいものがない時に進む道 〜 プログラミングを続けるための新しい視点
junmikai
0
4
職務経歴書を書くときの_ポイント1選.pdf
junmikai
0
20
炎上案件を通して 筋肉の成長を諦めた件
junmikai
0
34
フリーランス 勇気が9割
junmikai
0
20
シャイエンジニアのコミュニティ論
junmikai
0
41
雑談はファンタジーである
junmikai
0
10
未来のキャリアは「ヘアサロン」現象
junmikai
0
13
もくもく会怖くないよ〜
junmikai
0
18
Featured
See All Featured
Thoughts on Productivity
jonyablonski
66
4.2k
Distributed Sagas: A Protocol for Coordinating Microservices
caitiem20
326
21k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
43
2k
Art, The Web, and Tiny UX
lynnandtonic
294
20k
What the flash - Photography Introduction
edds
67
11k
5 minutes of I Can Smell Your CMS
philhawksworth
202
19k
A Modern Web Designer's Workflow
chriscoyier
691
190k
Build your cross-platform service in a week with App Engine
jlugia
228
18k
Faster Mobile Websites
deanohume
304
30k
Automating Front-end Workflow
addyosmani
1365
200k
The Power of CSS Pseudo Elements
geoffreycrofte
71
5.3k
Reflections from 52 weeks, 52 projects
jeffersonlam
346
20k
Transcript
コメントアウト するべきでは 「ない」こと 三海 純(ミカイジュン)
自己紹介 • 三海純(ミカイ ジュン) • フリーランスエンジニア ◦ Next.jsの新規開発 + Laravel
◦ Python API新規開発・設計 • 趣味 ◦ アニメ(BanG Dream!・ぼざろ 等) ◦ ネット麻雀(雀魂・雀豪)
キャリア • 2020/06 - 2022/02: 正社員(受託企業) ◦ Vue.js/Nuxt.jsをメイン • 2022/03
- 2023/09: 正社員(自社開発) ◦ バックエンドはPython / Nest.js(Node.js) ◦ フロントエンドはReact.jsとNext.js • 2023/10 - : フリーランス(自社開発) ◦ Next.jsの新規開発とバックエンドを担当 ◦ Python APIの新規開発・設計
この本はご存知ですか?
今回のゴール 紹介される エンジニア書籍 No.1 !!! ※個人の感想です
None
冗談はおいておき コードの書き方の 有名な書籍です
今回は・・・ 5章 コメント すべきことを知る について紹介したいと思います
// 金額を計算する const calculatePrice = (price, quantity) => { //
priceとquantityをかけて合計を計算 return price * quantity } const price = calculatePrice(1000, 3)
コメント必要ですか? // 金額を計算する const calculatePrice = (price, quantity) => {
// priceとquantityをかけて合計を計算 return price * quantity } const price = calculatePrice(1000, 3)
実際に後輩から言われたこと (コードからわかることでも) コメントがあった方が すぐにわかる からコメント書きたい
None
とはいえ・・・ - 前提知識があると無駄なコメ ント邪魔になる - 本当にコメントが必要な箇所 を見逃す
日常会話で解説
今日何が食べたい? カツ丼! わかった!か◯やで買ってくるね!
ここで問題です。どちらの カツ丼を買ってくるでしょうか?
正解は・・・
解説 引用元: https://www.arclandservice.co.jp/katsuya/menu/
質問です。なぜ わかりましたか・・・?
None
日本国内において最も一般的なカツ丼のスタイルは、 「豚カツとタマネギを醤油味の割下で煮込み、卵とじ にして、米飯にのせた料理」である。 単に「カツ丼」と呼んだ場合は、 一部地域(特に福井県、山梨県、群馬県、岡山県、沖縄県、長野県の南部) を除いてこの形態を基本とする。 一応解説
引用元: https://ja.wikipedia.org/wiki/%E3%82%AB%E3%83%84%E4%B8%BC
つまり、みなさんは 「カツ丼」に関して 前提知識がある ってことになるんですよ
つまり赤枠部分が「カツ丼」になる // 金額を計算する const calculatePrice = (price, quantity) => {
// priceとquantityをかけて合計を計算 return price * quantity } const price = calculatePrice(1000, 3)
今日何が食べたい? 豚カツとタマネギを醤油味の割下で煮込み、卵 とじにして、米飯にのせた料理! つまりカツ丼! ん?どういうこと? か◯やでいいんだよね・・・?
問題点1: 前提条件知ってる 豚カツとタマネギを 醤油味の割下で煮込み、 卵とじにして、米飯にのせた料理 つまりカツ丼!
問題点2: ノイズで正解を掴みにくい 〇〇とタマネギを 醤油味の割下で煮込み、 卵とじにして、〇〇にのせた料理
None
再掲載 - 前提知識があると無駄なコメ ント邪魔になる - 本当にコメントが必要な箇所 を見逃す
週末はカツ丼ライフを!
ではなく、 良い開発ライフを!
ご清聴ありがとうござ います!