Expanding the documentation

Matthew East mdke at ubuntu.com
Sat Jun 14 10:53:10 UTC 2008


On Fri, Jun 13, 2008 at 6:50 PM, Connor Imes <rocket2dmn at aol.com> wrote:
> Dougie Richardson wrote:
>>> Nevertheless, I think there is a need to mark-up documentation which
>>> has
>>> been recognised as being of good quality. Maybe something a little less
>>> intrusive than a banner across the top of the page, like a star (as per
>>> Wikipedia's "featured articles")?
>> Feel free to shoot this down but could we implement some JavaScript to allow
>> people to rate pages if they were useful.
> Functionality like that sounds like it could be useful, not sure on the
> logistics of implementing it anytime soon, though.  Thoughts?

I'm very cautious about a rating system - I don't think it will
produce as reliable results as the cleanup categories which the
documentation team can apply. I also think an advanced feature like
this is likely to be running before we are walking. We need to keep
our ideas simple and take things one step at a time. The
HelpWikiQualityAssurance specification deals with user feedback in a
simpler way - let's stick to that for now and see how it goes.

Matthew East
gnupg pub 1024D/0E6B06FF

More information about the ubuntu-doc mailing list