talk

Revision 9 as of 2007-04-05 23:19:25

Clear message

Discussion of HelpWikiQualityAssurance.

With regards to versioning pages:

  • Say a page applies to 5.04 and 5.10 but not 6.06. Users will wonder what is different in 6.06, information should be provided: "works on 6.06 by default" or "replaced in 6.06 by $something"
    • This is specially important if we provide a better way of doing things, like the dist-upgrader tool to avoid apt-get dist-upgrade. This "breaks" what old users expect, and they should be informed clearly.
  • Adding category version tags will need constant maintenance as each release rolls out and older releases become unsupported
    • e.g. all pages marked "5.10" will need to be cleaned out once it outlives its support lifespan. This could be easily parsed for by searching across the category tag though.
  • Is there a need for adding category version tags for individual software applications or just Ubuntu releases?
    • i.e. do we need to tag OOo 2.0.3 versus 2.0.2 as changes are introduced?
    • My feeling is that such micro-management would be unnecessary and impractical. Major application changes are likely to happen across releases.
  • If we categorise pages according to release numbers then two scenarios could occur:
    • an application/procedure persists across releases:
      • we could tag pages inline as to which situations/contexts refer to which release (as mentioned above)
    • an application/procedure is superseded, replaced or has major changes made:

      • we might need separate pages for each release-specific context
      • this could be tricky as the wiki page's namespace would then become release specific as opposed to the version category

Navigation:

  • Make sure there are clear links to parents, parent catagories, home and previous, whenever possible/applicable so to avoid users getting lost. (currently the only way to get back to home is to click the documentation link in the top navigation bar)

CategoryCleanup

On July 17, 2006 there were 344 pages in CategoryCleanup. Given the amount of people with time available to work on CategoryCleanup, we cannot possibly keep this list short.

For that reason, I suggest that when it comes to quality assurance efforts we limit ourselves to simply indicating why any one page is placed into CategoryCleanup. We need some mechanism so that random wiki users will know why the page is in CategoryCleanup.

The notification below is a suggestion.

To meet the quality standards for Community Docs, this article or section requires additional work.

Text specific to the problem goes here. Problems can be grammar and spelling, technical, style, or whatever. Include links to appropriate help sections on the wiki.

You can discuss this issue on either Freenode IRC channel #ubuntu-doc or on the mailing list.

This page was placed into CategoryCleanup by (name here) on (date here)

This method does not require the creation of new macros. When you put a page into CategoryCleanup, simply copy-and-paste the above table into the top of the page and modify it as required.

People should know why the page needs cleaning up so they know whether or not they can trust the content. If the note says that the page is in CategoryCleanup for poor grammar and spelling only, then people will know that they can rely on the information in the page. As a bonus, they may even be motivated to do the cleaning up themselves. As it is now, merely placing the tag CategoryCleanup says nothing about the condition of the page.

It's very easy to put the CategoryCleanup tag onto a page, but difficult and time-consuming to actually fix the problems, especially if you don't know why the page is there in the first place.

Also, simply sticking a page into the category is a blunt instrument, and might deter people from further contribution. We treat contributors with a bit more respect when we take the time to indicate exactly why their page falls short, tell them who put their page into the category, and give links to information that might help them out.

CategoryReview

Although this category was suggested earlier on the mailing list, we probably don't have the resources available yet to do a proper job of reviewing in a timely manner all the pages that would end up in it.

Wiki Software

What software is used for this wiki, and why? MediaWiki (the software used by Wikipedia) has several useful features this wiki is missing. For example, Talk pages are automatically bound to the article pages, there is a list of [http://en.wikipedia.org/wiki/Special:RecentChanges RecentChanges], and I think templates (macros) are easier, though I haven't figured out how they work here. --MattFlaschen

  • I just found the RecentChanges here. Smile :) --MattFlaschen

    This wiki is [http://moinmoin.wikiwikiweb.de/ Moinmoin]. MediaWiki is the best wiki engine. Unfortunately, in my opinion, it's impossible migrate to another platform (most expensive, most difficult). But this isn't a problem. With Category, Macro, guide-line how-to write a guide and control operator it's possible have all under control. Hi all. GiuseppeTerrasi