Worst Phobos documentation evar!

[ketmar via Digitalmars-d]

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

> On 12/30/2014 10:44 AM, 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. sure, markdown will not magically solve other problems, but at
> > least it will remove one of the annoyances, which is good in itself.
> 
> Come on. An example, for example(!), is just inserting D code between ---, and 
> better examples would be very helpful.

ah. it's incredibly hard to make a good example. yet i hope to gather
some examples soon, as it is possible that i will train some mates in
D. i will consider to look what parts of documentation are hard for 'em
and what examples i will devise to explain the things, and then i
will try to submit some ERs.
-------------- 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/412c7424/attachment.sig>