08/12/20 03:28:56
>>349
getSource()がpublicのmethodならば「Get Source」だけでは説明不足。
これでは何のsourceが返るのかソースコードを読まないとわからない。
そもそもmethod名から推測できるもの以上の情報が得られないから
コメントを書く意味が無い。
また、初期条件は何なのか、nullが返される場合があるのか、
例外は投げられるのか、など説明すべきことが他にもあるのでは。
08/12/20 03:28:56
>>349
getSource()がpublicのmethodならば「Get Source」だけでは説明不足。
これでは何のsourceが返るのかソースコードを読まないとわからない。
そもそもmethod名から推測できるもの以上の情報が得られないから
コメントを書く意味が無い。
また、初期条件は何なのか、nullが返される場合があるのか、
例外は投げられるのか、など説明すべきことが他にもあるのでは。