コメントのいらないプログラムの書き方｜NZ MoyaSystem

パラメータを決める 次に関数に渡すパラメータを決めます。 関数の名前で表現されている処理を実現するには、どれだけのパラメータがあればよいか？ と考えてみましょう。 今回の例でいえば「お客さんの年齢」と「日付」があれば、すべてのチケット価格が計算できます。 ということで、age と date の2つのパラメータを渡すことにします。 function calculateTicketPrice (age, date) { } パラメータの名前も、なにを表しているかわかるようにしてくださいね。 くれぐれも「hensu」とか適当な名前をつけたり、同じ変数にぜんぜん違う値を繰り返し代入したりすることのないようにしましょう。 テストを書く 次にユニットテストを書きましょう。 テストは常に更新される仕様書です。 業務ロジックをテストに説明させておけば、関数の仕様をコメントにいちいち書く必要などありません。

[odakaho]

NG。コメントは処理の意味でなく仕様の意図を書く。

[lovevoiceryu]

コメント無しでわかるコードを書いた上でコメントも書く。

[masatomo-m]

「コメントいらない」教の人達って超簡単なサンプルを挙げるけど、簡単なコードしか書いてないのかな？外部システム仕様との関連とか試行錯誤の結果のやむを得ない糞コードとかコメントに書かざるをえないことは多い

[poponponpon]

読みやすくするのはいいけどコメントを書かないことが目的になってない？ミニマリスト感を感じる。

[ghostbass]

一時期同じ主張をしてたけど、最近は「可能な限りコメントなしで(今の自分に)分かるように書いて、他人または未来の自分のために必要な情報をコメントで残す」方にシフト中。

[caynan]

なぜ人は「リーダブルコード」や「Clean Code」でガッツリ議論されている事柄を再発明したがるのか

[umai_bow]

そんなものは無いからコメントを書け。「このライブラリはこういうバグがあって、こういう書き方じゃないと動かない」「このコードは別の仕様がマージされ次第不要になる」いくらでもあるはず

[naopr]

定期的にコメントいらないマンの記事が上がってくるけど、自分にとって納得感があった試しがない

[bobniku]

なんでこんな簡単な例なんだろう。大概コメントは、将来の新人のため、関数内で完結しない処理のため、あえて変なコードにした背景、とかだと思うけどなぁ…。その段階でダメという主張なら違う例になりそうだし。

[uva]

そうはいってもgithubなんかで全く知らない他人のコード読む時にコメントある方が明らかに読みやすいし

[nilab]

コメントのいらないプログラムの書き方 - NZ MoyaSystem

[diveintounlimit]

function hyottosshiteSorehaGyaguDeItterunoka() {}

[TakayukiN627]

要求仕様とそれに対応する部分のコードとテストしか見せられていないのに、「ねっ、コメントいらないでしょ」と言われても…。※実際の開発時のコードにはもっと細かい記述が必要なので。

[naoto_moroboshi]

書いてないと自分でわかんなくなるもん。コードより日本語読む方が理解早いし。そりゃこのサンプルならいらんだろうけど。

[J138]

やっべー正規表現並んでる時にコメントあって死ぬほど助かったことある。ってか関数名にマジックナンバ埋めるなw Thirteenってなんだよ。

[ene0kcal]

エントリをきちんと読んでない、意図を汲み取れてない、記事の目的を理解していない人多い。そういう人は時間を置いて100回読み直す事を勧めたいが。ちなみに仕様意図コメントを否定しているエントリではない事に注意

[ad2217]

考え方を逆にして、文芸的プログラミングをするのですよ。web で weave するのですよ。

[nmcli]

一通り読んで、あこれコメント必要なシーンあるわって逆に思った

[pmint]

変数名・関数名はコメント。処理に影響しないし。テストコードは愚直で問題無い。

[koriym]

オープンソースのコードのソースに答えが書いてある ... と書こうとしたけど

[torinosito]

これも一種の中二病？人と違うことをしたいってやつですし。　まあ極端に走るのは何にせよダメで、適度なコメントと分かりやすい関数名変数名の両方があるといいよね。目が泳ぐようなぶち長いのは論外として。

[nida3001]

コメントについてのブログ記事書く時の引き合いに良いのでブクマ

[pho2017]

逆にわかりにくくなっている件

[nice801]

こんな読みにくいコードやだ、普通にコメント書いてください

[AfroRay]

“関数を「When (条件) Then (動作)」の形式で命名するようにしておくと、コメントなしでも条件が理解できるのでオススメです。”

[luccafort]

コードはただの振る舞いでしかないので何故そうあるべきか？を書くのがコメントだと思う。ただコメントがいらないようなコードを書くべきというのは理解できる。

[versatile]

コメントを笑うもの、コメント（の無さに）泣く

[onefootinthegrave]

日本語変数名、日本語メソッド名で書くとコメントだいぶ減る

[gayou]

で、こういう人が書いたコードが数年後のメンテの時に誰もわからないってことになるのでは。

[Wafer]

そりゃこんなバカな関数名つけるような奴は現場でプログラム書いていられなくなってニュージーランドに逃げるよねぇ

[UhoNiceGuy]

ふーっ荒れてる//コメントはなくても意図が読めても、あったほうがいいんだ。例示の動作を表すコメントは２、３行ですむ書いて損はない

[tohta111a]

参考になりました

[pinzolo]

コメントの意義についてはさんざん出ているのでおいといて、とりあえず Enclosed とか Nested 使ってくださいと言いたい

[sora1530]

コード書くときは必ずコメントアウトするように教わりますね。コメントは誰が見ても分かるようにするための「優しさ」ですかね

[NetPenguin]

全部読んでないけど、プログラムコードに意図は埋められるけど、動機はかけないから、WHYをコメントとして書くという、良くいわれていることにいきつく（きっとブコメもそんな感じの事で溢れているのかな……）

[nadanonadanotamenonadaniyoru]

全部実装してるけど、コメントはいると思う。ソースをパッと見ただけで思い出せるし、何より「なぜ」を書けるから。

[Palantir]

コメントだけ書いてソースはかかない

[rew05]

「何のために書いてあるか」をコメント無しで説明するの無理じゃねえの。

[hitsujiniku-sugita]

コメントに親でも殺されたのか

[rainbow_doll]

コメントいらない派を装ったネガキャンだ　ほんと迷惑