Lost a new commercial user this week :(
uri via Digitalmars-d
digitalmars-d at puremagic.com
Fri Dec 19 05:03:54 PST 2014
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.
More information about the Digitalmars-d
mailing list