[hackathlon] stdc ddoc needed ?

Walter Bright via Digitalmars-d digitalmars-d at puremagic.com
Sun Apr 26 13:45:34 PDT 2015


On 4/26/2015 11:38 AM, Baz wrote:
> Hi, is it worth documenting stdc ?

No. In general, D should not be re-documenting APIs where the documentation 
exists elsewhere, because:

1. have to rewrite it because of copyright
2. such rewrites introduce errors and ambiguities
3. documentation always gets out of date
4. a user would be foolish to use re-documentation rather than the official 
documentation
5. our time is much better expended on more productive things.

> I'm about to copy all the docs from offical sources, e.g
> http://www.cplusplus.com/reference/cctype/.
>
> There's been a post from W.B a few weeks ago about undocumented sources.
> I don't remember if it included stdc.

It doesn't include API interfaces.

Thanks for asking before doing the work. I'd sure hate for you to expend a lot 
of effort on this only to have it rejected. We can't afford to waste effort like 
that.


More information about the Digitalmars-d mailing list