"Getting involved" on dlang.org?
Ola Fosheim Grøstad via Digitalmars-d
digitalmars-d at puremagic.com
Wed Dec 2 02:53:45 PST 2015
On Wednesday, 2 December 2015 at 01:40:36 UTC, Adam D. Ruppe
wrote:
> BTW on the topic of documentation, I actually hired a junior
> programmer with no D experience to write some D tutorials with
> me. It was actually kinda eye opening to see all the things I
> take for granted being a stumbling block for her.
A technique for making high quality manuals is to have a passive
expert sit next to a new user and have the new user try to use
the machinery and ask questions whenever there are issues. Then
you repeat it with some other new users and use the recorded
question-answer results to figure out what is needed for the
printed manual.
More information about the Digitalmars-d
mailing list