**Proposal**: We need a gadget to measure user perceptions of usefulness and usabilty of technical documentation on Wikitech. The gadget should initially provide very basic feedback about whether documentation is useful or not to our users. The feedback will help guide an iterative documentation process focused around user needs and help us to target areas where we can best apply our resources.
Initially, the gadget would be available on Wikitech documentation pages only.
The idea is to start with existing documenation and to have a feedback mechanism for users with a simple question:
Was this documentation helpful?
The answer should be (Yes or No | thumbs up or thumbs down)?
If the answer is no, users would be presented with a text box to gather further information about why the feedback was not useful.
Another version of this gadget might be a scale or star rating with the same basic idea behind it (less than 4 stars would trigger a mechanism to gather more user feedback)
Though the idea is to have a fairly simple mechanism intially, we might consider a variety of questions going forward:
* What is the purpose of your visit today?
* Did you find the information you were looking for?
* What do you like most / least about the information on this page?
* Is there anything you care to share about your vist to this page?
* How did you find this page?
* How can we improve?
If possible, it would be nice to be able to gather some additional metrics.
* How many times a page had been viewed?
* How long the average page views were?
There are a couple "wish to haves" for the feedback gadget.
* A simple thank-you message that comes up after the visitor has particpated in the survey. (It takes time to fill out a survey.)
* A persistent link to help/support. (The theory is that it should be easy and comfortable for users to reach out and ask questions when they have them.)