[documentation] Include Survey in the Handbooks

Robert Castelo robert.castelo at cortextcommunications.com
Sun Feb 12 13:43:07 UTC 2006


The great work Kieran has been doing conducting surveys and usability 
testing got me thinking about other ways in which we might also test 
and improve Drupal documentation...

I'd like to propose a survey feature be added to the bottom of every 
page of Drupal handbooks. The survey would consist of voting on 3 or 4 
questions, which would rate the effectiveness of pages.

Questions might be:

Title - Is it clear what this page is about from reading the title?
Position in handbook - Is this the right place for this page?
Content clarity - Is this page well written and clear?
Content information - Does this page contain enough information?

By having the survey on the pages themselves we are surveying the 
people who use the handbooks. This gives us a large number of 
participants, guarantees that we are surveying the relevant user group. 
Also we are not giving participants tasks to carry out and then 
measuring how well they do, users are performing tasks they themselves 
think are important.

This also has the advantage that testing is continuous, so we can track 
usability over time. We could even tie in the results to page revisions 
to see how revisions effect usability.

I'll leave out for the moment technical details of how such a survey 
could be set up, what do you think of the idea?



Best regards,

Robert



More information about the documentation mailing list