アカウント名:
パスワード:
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
UNIXはシンプルである。必要なのはそのシンプルさを理解する素質だけである -- Dennis Ritchie
コメント部分 (スコア:1)
doxygen などで出力するために詳しく書いていますから。
コメント行数 > 関数行数、なんてのも多数。
#この話題での行数ってステップカウント換算なのかしら?
Re:コメント部分 (スコア:0)
C/C++の場合、ヘッダファイルとソース、コメントはどっちに書きますか?
ヘッダを見る利用者のためにヘッダに書くべきだ、という意見もわかるし、ヘッダの見通しが悪くなると全体が把握しづらくなるのでソースに書くべきだっていうのも同意できる。doxygenなんかは、ヘッダに短いコメント、ソースに詳細なコメントなんかをサポートしててそれは前者と後者を両立させてるとは思うんだけど、同じような内容を二度書くのはちょっと面倒だし、修正したときに片方のコメントの修正を忘れることもしばしば・・・。
なんかいい指針ないかな?
Re:コメント部分 (スコア:0)
実装部分に書くのはhow
客に書いて欲しいが書いてくれないのがwhy