discuss disqus

[Kagamin via Digitalmars-d]

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.