JavaScriptのコメントは不要か？ | POSTD

コード中にコメントを書くべきでしょうか？ 是が非でも避けるべきでしょうか？ それとも控えめに書けばいいでしょうか？ 開発者たちはそれぞれ、ソフトウェアを開発する際にどのように、そしてどんな時にコメントを書くかについて、独自の考え方を持っています。この記事では私の意見を述べますが、これが誰にも当てはまるというわけではありません。 なお、関数型プログラミングまたはオブジェクト指向プログラミングの原則に則ってJavaScriptで書かれたソフトウェアに絞った上で、私の意見を述べることにします。 コメントと保守性 この記事では、保守性のあるコードを書く場合について考えます。つまり、以下のようなコードです。 簡単に理解できる 簡単に拡張できる 簡単にデバッグできる 簡単にテストできる 保守性のあるコードには、大量のコメントが必要でしょうか？ 明確に書かれたコードであるならば、大量のコメントは不要だと

[rti7743]

10年前に書いたコード読み返して思うのは、なぜするのか、どうしてするのか系のコメントは役に立ちそれ以外はさほど役には立たなかったな。

[kjtec]

コメントについて。

[doublehorn93]

JavaScriptのコメントは不要か？

[isrc]

そのコメントが何らかの価値を加えるものであれば有益であると考えます／きちんと書かれたヘッダコメントがあれば、コード内のコメントの99.99%は不要

[you21979]

コード内にコメントを日常的に書いてたらダメなのは同意だなぁ。コメントが必要ならヘッダに書くべき。ヘッダに書くならふるまいベースで書くと思うし。

[bleu-bleut]

クラス毎、メソッド毎にヘッダーコメントがおすすめ…

[Dai_Kamijo]

JavaScriptのコメントは不要か？ | プログラミング | POSTD @POSTDccさんから — 上條　大 (@Dai_Kamijo) October 9, 2015 from Twitter https://twitter.com/Dai_Kamijo October 10, 2015 at 06:55AM via IFTTT

[NineGates]

JavaScriptのコメントは不要か？ コード中にコメントを書くべきでしょうか？　是が非でも避けるべきでしょうか？　それとも控えめに書けばいいでしょうか？　開発者たちはそれぞれ、ソフトウェアを開発する際にどのよう

[trashtoy]

基本的にIDE(を使う人)にやさしいコメントを書くようにしたい

[k--kato]

ES6 Arrow Functions の引数に型コメントを書きたいです。 let logger = (/* String */ log) => elm.value += log;

[Error401]

(未来の)自分にとって有用かどうかも重要だけど、他者にとって有用かどうかも重要。Javascriptの場合、「@param {type} name description」のコメントがないと読むのが苦痛。

[VoQn]

ヘッダコメントは要るし、内部のちょっとした部分にもコメントは結局要る派（特にXP指向してるならmasterマージまではザクザク入れろと思う）

[hex64]

JavaScriptのコメントは不要か？ | プログラミング | POSTD

[masakiplus]

コード中にコメントを書くべきでしょうか？　是が非でも避けるべきでしょうか？　それとも控えめに書けばいいでしょうか？　開発者たちはそれぞれ、ソフトウェアを開発する際にどのように、そしてどんな時にコメン

[lizy]

やっぱり静的型がある方が読みやすい

[pipehead]

http://www.zsoltnagy.eu/are-javascript-comments-useless/ の和訳; 宣言的なヘッダコメント