Worst Phobos documentation evar!

ketmar via Digitalmars-d digitalmars-d at puremagic.com
Tue Dec 30 12:04:12 PST 2014


On Tue, 30 Dec 2014 19:47:53 +0000
"Adam D. Ruppe via Digitalmars-d" <digitalmars-d at puremagic.com> wrote:

> On Tuesday, 30 December 2014 at 18:44:15 UTC, ketmar via 
> Digitalmars-d wrote:
> > but the unnecessary noisy (and badly documented, that's it)
> > documentation language surely doesn't add any joy for 
> > documentation writer.
> 
> Yeah, I see that too; I complain about ddoc as well (though I 
> generally like it, I just wish it encoded the output correctly 
> and had some nicer defaults, but I don't care enough to fight 
> over it) but I don't think it is that big of a block because the 
> hard part is writing the text rather than the formatting.

sure, we need the actual text in the first place. ;-) but making it
easier to create and format that text is good too.
-------------- 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/fe95d327/attachment.sig>


More information about the Digitalmars-d mailing list