Worst Phobos documentation evar!

[ketmar via Digitalmars-d]

On Tue, 30 Dec 2014 12:26:52 -0800
Walter Bright via Digitalmars-d <digitalmars-d at puremagic.com> wrote:

> On 12/30/2014 11:49 AM, Andrei Alexandrescu wrote:
> > On 12/30/14 11:47 AM, Adam D. Ruppe 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.
> >
> > Agreed! -- Andrei
> >
> 
> I agree so strongly that just email me the freakin' text and I'll mark it up and 
> submit it. Ketmar, I expect my email inbox to fill up promptly! :-)

i'm sux in writing documentation. i'm always explaining the things that
are perfectly clear for everyone and failed to explain the things that
are not so obvious ('cause they are obvious to me ;-). so i doubt that
it even pass spamcheck.

besides, if i start to do some real work, i will not have enough time
to write my rants here!
-------------- 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/74cdd526/attachment.sig>