On Thursday, 19 March 2015 at 22:05:51 UTC, Walter Bright wrote:
On 3/19/2015 2:40 AM, deadalnix wrote:And I'm sorry, but if most function require DDoc, your code probably sucks quitebadly and some renaming should be considered.I've never seen any code that self-documented "why".
Indeed, that is why comment are useful. If all your method require a why, you probably should consider refactoring instead of adding comments all over the place.