[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