Worst Phobos documentation evar!
ketmar via Digitalmars-d
digitalmars-d at puremagic.com
Tue Dec 30 10:44:05 PST 2014
On Tue, 30 Dec 2014 15:20:30 +0000
"Adam D. Ruppe via Digitalmars-d" <digitalmars-d at puremagic.com> wrote:
> On Tuesday, 30 December 2014 at 01:50:01 UTC, ketmar via
> Digitalmars-d wrote:
> > D documentation WILL be bad until ddoc will start to understand
> > some markdown-like mostly macro-free markup language.
>
> I honestly don't think the macros are the biggest problem though.
> I think a bigger deal is the lack of overviews.
but the unnecessary noisy (and badly documented, that's it)
documentation language surely doesn't add any joy for documentation
writer. sure, markdown will not magically solve other problems, but at
least it will remove one of the annoyances, which is good in itself.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 181 bytes
Desc: not available
URL: <http://lists.puremagic.com/pipermail/digitalmars-d/attachments/20141230/6ce1cda3/attachment.sig>
More information about the Digitalmars-d
mailing list