[B! sourcecode][comment] astk_fのブックマーク

astk_f id:astk_f

sourcecodeとcommentに関するastk_fのブックマーク (2)

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

javascript

sourcecode

comment

example

開発
リンク
Backbone.js コメント付きソースコード日本語訳
Annotated Sourceのコメントを訳しました地味に道のりが長い作業でしたが、何とか先々週末にやっつけて、例によって@cssradar氏に確認していただいたりとかして今に至りご紹介する次第。日本語訳コメントがついたソースコード· enja-oss/Backbone · GitHub なんだかんだで全域を網羅する必要があったたので、非常に勉強になりました。ソースコード自体は短く簡潔なので、Backboneをこれから使い始める/もう使ってるを問わず、まだ読んでない方は一度読んでみると良いです。監訳謝辞 Revert original text for supervise by ahomu · Pull Request #12 · enja-oss/Backbone 上記Pull Request＆監訳依頼につきまして、多大なるレビューをしてくださった@cssradar 氏に感謝を。
astk_f 2012/12/16
backbone.js

sourcecode

日本語

comment
リンク
1