Enhancement: issue error on all public functions that are missing ddoc sections
deadalnix via Digitalmars-d
digitalmars-d at puremagic.com
Thu Mar 19 15:27:33 PDT 2015
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 quite
>> badly 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.
More information about the Digitalmars-d
mailing list