brainstorming1Add my vote for this tag create new tag
, view all tags

Let TWiki users help us improve the documentation

On commercial sites there's often a way for someone seeking help to rate documents regarding whether they found the document helpful (vague) or whether the document answered their question (better). Getting feedback of this sort might be helpful, although I don't know how well these systems work. (I wonder if there's research out there.)

We ask people to help improve the documents since, this being a wiki, they can (at least in theory, unless svn smooshes things). Most of the time, I suspect, people will treat the TWiki documentation as read-only and the best we can expect is for them to rate the document in some easy-to-use way.

Perhaps we could use the tagging mechanism in a different manner for this purpose, with values such as "Answered my question", "Confusing", "Helpful", and so on. This would be orthogonal to the tagging of topics for categorization, which in the case of documentation requires considerably more expertise than non-developers have. Assuming enough people take the time to do this sort of tagging, we can get guidance where we might most productively spend our limited resources in this area.

(As a side note, we definitely need more FAQs as well as more HowTos and recipes. This might help to ease the burden of helping with support.)

-- Contributors: MeredithLesly


Topic revision: r1 - 2006-03-16 - MeredithLesly
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2017 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.