On Friday, 19 December 2014 at 12:53:32 UTC, Tobias Pankrath
wrote:
On Friday, 19 December 2014 at 12:44:26 UTC, Kiith-Sa wrote:
On Friday, 19 December 2014 at 09:13:07 UTC, Walter Bright
wrote:
On 12/18/2014 2:24 AM, Manu via Digitalmars-d wrote:
Docs need to have examples which are plain and obvious, and
the
language will be absorbed by osmosis.
I agree. Can you point to specific cases that need an example?
If it doesn't have an example, it needs an example, no matter
how trivial it is. That's a good place to start. Of course,
then there are lazy examples that don't really help in real
use. These need to be identified and rewritten.
• If you look up how to do $x in the documentation and it is
takes you time to figure that out, consider to add an example
for $x to the documentation.
• If you answer/ask a question in D.learn on how to do $x,
consider to add an example for $x to the documentation.
This way we should build up exactly those examples that are
useful.
+1
No different to adding unit tests where possible for each
reported bug.
