>>109
申し訳ないが、例示もできないで説明しますたなんていえないから
テキトーこしらえた
不備はある

実務だとどうするかはわからんが、とにかく「3日後の自分がわかる」程度に
関数名 or メソッド名に配慮して「何をしてます」が伝わるように試みる
設計書のほうでなんでそんなことしてんのか、の説明に徹する感じ

そもそも俺の場合、設計書を書けるほどの時間的余裕がある案件は
ほとんどなかったせいかもしれない