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.
- Re: "Getting involved" on... Ola Fosheim Grøstad via Digitalmars-d
