Enhancement: issue error on all public functions that are missing ddoc sections

w0rp via Digitalmars-d digitalmars-d at puremagic.com
Thu Mar 19 12:54:56 PDT 2015


On Wednesday, 18 March 2015 at 18:48:53 UTC, Walter Bright wrote:
> I'm fed up with this problem. It is actively hurting us every 
> day.
>
> https://issues.dlang.org/show_bug.cgi?id=14307
>
> Anyone want to take this on? Shouldn't be particularly 
> difficult.

I think this is a good idea. Even the most trivial looking 
function might not be so trivial looking to consumers of the API. 
Document everything. If you can't explain a function in a public 
API (where protected is also public), then why should it exist?


More information about the Digitalmars-d mailing list