ソースのコメントを英語で書くスレ

ソースのコメントを英語で書くスレ at TECH

351:デフォルトの名無しさん
08/12/20 03:28:56
>>349
getSource()がpublicのmethodならば「Get Source」だけでは説明不足。
これでは何のsourceが返るのかソースコードを読まないとわからない。
そもそもmethod名から推測できるもの以上の情報が得られないから
コメントを書く意味が無い。

また、初期条件は何なのか、nullが返される場合があるのか、
例外は投げられるのか、など説明すべきことが他にもあるのでは。

次ページ

続きを表示

1を表示