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
Sponsored
·
Your Podcast. Everywhere. Effortlessly.
Share. Educate. Inspire. Entertain. You do you. We'll handle the rest.
→
ミカイ
April 02, 2024
0
100
コメントアウトするべきでは「ない」こと
ミカイ
April 02, 2024
Tweet
Share
More Decks by ミカイ
See All by ミカイ
今からフロントエンドを0から勉強するならSvelteもありかも
junmikai
0
86
tsoaはいいぞ!APIドキュメントを自動生成!
junmikai
0
49
生成AI活用はHOWが大事な理由
junmikai
0
170
2025年の抱負: フリーランスから 正社員に戻るので 組織に貢献します!
junmikai
0
110
Chakra UI v3にバージョンアップしてほぼ別物になった件
junmikai
0
1.1k
LTのテーマ決めは「多数派」を意識しよう ~ LT年40回登壇した件~
junmikai
0
41
成長するには「重要 VS 緊急」を意識しよう
junmikai
0
18
LTのテーマ決めは「多数派」を意識しよう ~ LT年40回登壇した件~
junmikai
0
44
目標は「めいそう」が大事。漢字はどう書く?
junmikai
2
59
Featured
See All Featured
Money Talks: Using Revenue to Get Sh*t Done
nikkihalliwell
0
180
[RailsConf 2023] Rails as a piece of cake
palkan
59
6.4k
Designing Experiences People Love
moore
143
24k
Refactoring Trust on Your Teams (GOTO; Chicago 2020)
rmw
35
3.4k
Into the Great Unknown - MozCon
thekraken
40
2.3k
The Curious Case for Waylosing
cassininazir
0
270
brightonSEO & MeasureFest 2025 - Christian Goodrich - Winning strategies for Black Friday CRO & PPC
cargoodrich
3
120
XXLCSS - How to scale CSS and keep your sanity
sugarenia
249
1.3M
Fantastic passwords and where to find them - at NoRuKo
philnash
52
3.6k
Public Speaking Without Barfing On Your Shoes - THAT 2023
reverentgeek
1
330
Visual Storytelling: How to be a Superhuman Communicator
reverentgeek
2
470
DBのスキルで生き残る技術 - AI時代におけるテーブル設計の勘所
soudai
PRO
62
51k
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
再掲載 - 前提知識があると無駄なコメ ント邪魔になる - 本当にコメントが必要な箇所 を見逃す
週末はカツ丼ライフを!
ではなく、 良い開発ライフを!
ご清聴ありがとうござ います!