Menu
Sign In Search Podcasts Charts People & Topics Add Podcast API Pricing
Podcast Image

リファクタリングとともに生きるラジオ

#20 コメント① コメントを「ちゃんと書く」って何?

29 Apr 2024

Description

■ トピック 「コメントをちゃんと書きましょう」 コードの日本語訳のようなコメントは消してほしい 良くないコメントがあるよりは無い方がマシ コメントを書かないでいいようなコードを書きたい 「何を書いてはいけないのか」がわからないといけない コードスメル、消臭剤としてのコメント 情報として有益であっても消されるべきコメント 申し訳なさとともにコメントを書く 交通標識のように機能するコメント 読まれるべきコメントへの注意を引くためにはS/N比が大事 ■ 参考リンク O'Reilly Japan - リーダブルコード エンジニアのためのドキュメントライティング - JMAM 日本能率協会マネジメントセンター リファクタリング(第2版) 既存のコードを安全に改善する | Ohmsha ■ おたよりフォーム https://forms.gle/RYUG7T4ctmF7Srf36 ■ X(Twitter) https://twitter.com/refactoradio ハッシュタグは #リファラジ です。

Audio
Featured in this Episode

No persons identified in this episode.

Transcription

This episode hasn't been transcribed yet

Help us prioritize this episode for transcription by upvoting it.

0 upvotes
🗳️ Sign in to Upvote

Popular episodes get transcribed faster

Comments

There are no comments yet.

Please log in to write the first comment.