Rikki Cattermole via Digitalmars-d
digitalmars-d at puremagic.com
Sun Mar 15 17:13:51 PDT 2015
On 16/03/2015 8:08 a.m., Walter Bright wrote:
> On 3/14/2015 8:32 PM, Rikki Cattermole wrote:
>> This might be a bit of a out of scope, but auto generating of DDOC
>> comments for
>> symbols would be nice. Basically to enforce before e.g. committing that
>> everything has been explained.
> Autogeneration of documentation is by definition useless. Documentation
> is for 'why' and 'how'. Autogeneration can never be more than
> reformatted source code.
It is yes. No disagreement there.
Its just a real pain to create these stubs by hand. Atleast this way,
people will moan about documentation being empty and it'll seem less
work to do.
More information about the Digitalmars-d