On Wednesday, 30 July 2014 at 17:32:40 UTC, Brad Anderson wrote:
What comes to mind for me are micro-tutorials. When I was using
PHP back in the day I'd be trying to do something and I'd find
the function I could use to do it but figuring out exactly how
to make use of the function to accomplish what I wanted wasn't
always straight forward. The PHP comments would often have
comments along the lines of "Trying to do X? Here's how...".
Cluttering up the main documentation with lots of these types
of things would choke out the essential material the
documentation covers with a lot of material not everyone needs
to know. You could think of it like an appendix.
Every library section in MSDN is divided into "About", "Using"
and "Reference" subsections. "About" is a short explanation, what
the module does, "Reference" is what we have now on dlang.org and
"Using" explains, how to do various things with the module.
