最低限のルールですが、読みやすそうで読みにくい名前があったりします。
例1:
if (dataCheck)
処理A();
else
処理B();
これではdataCheckでエラーがあった時の処理は A/Bのどちらか判別付きません。
そのように指摘すると、
dataCheckメソッドのソースのHeaderに
// 戻り値: true: 正常 : false: 異常データ存在
と明記されているので判別付きます。
と愚痴られた上で、ソースは
例2:
if (dataCheck) // true: 正常 : false: 異常データ存在
処理A();
else
処理B();
となっていた。
これだとソース本体とコメントとメソッド仕様の3箇所を読まないと意味が掴かめません。
諸兄達が論じているように、判定ルーチンは is_XXX類の命名にすればいいと思っています。
例3
if (is_dataCheck_OK)
処理A();
else
処理B();
if (is_dataNoError)
処理A();
else
処理B();
のように 戻り値がbool型の時は is_xxx が読みやすいです。
日本語命名の時はどうなるんだろう
if (データ正常) ?
if (データ) ?
if (エラー無) ?
if (isデータチェック) ? : ローマ字混合は引っかかるなぁ
動詞+名詞の規則ができないので命名し難いでずか if (データ正常) が解りやすいかな
可読性の意識は個人差があるので、記述標準で規定して強制するしかないのかなぁ。