Re: Usability testing LilyPond's documentation

[David Kastrup]

Trevor Bača <trevorbaca@gmail.com> writes:

> Hi,
>
> Particularly if you teach LilyPond in a classroom environment:
>
> Has anyone on the user list ever usability-tested LilyPond's docs? For
> example, at the end of a semester course that you've taught, asking a
> handful of your students to perform a small task with LilyPond that they
> might not yet know how to do, and to verbalize their thought process as
> they click through the documentation and try things out? ("Here's a small
> snippet with three hairpins. Can you make the ends of the second hairpin
> stick out just two staff spaces wider?") Usually this is done on camera
> (Zoom is great for this), with the number of clicks / amount of retries /
> amount of time necessary to complete the task recorded.
>
> Has anyone on this list done this?

This is pointless as long as the intersection of the people complaining
about the documentation and the people writing documentation is empty.

The path to improving LilyPond does not lie with telling the few
remaining volunteers that they are doing a bad job.

-- 
David Kastrup