BetterWikiDocs

Differences between revisions 4 and 5
Revision 4 as of 2005-10-24 09:15:23
Size: 1608
Editor: mailgate
Comment: added some Rationale
Revision 5 as of 2005-10-24 09:20:10
Size: 1608
Editor: mailgate
Comment: adding corey as second
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
 * People: MatthewEast, NeedsSecond  * People: MatthewEast, CoreyBurger

Summary

Better Wiki - Moin needs some major love for doc work. We need to talk about how to achieve that.

Rationale

The following problems arise with regard to the documentation currently on the wiki:

  • The wiki has a vast quantity of non-documentation, which is muddling for users in searches.
  • The wiki has many specs with addresses that look like documentation (e.g. BluetoothSupport) which means that users waste time going looking for red herrings

  • The wiki documentation is not in the same place as the static documentation released by the Documentation Team at [help.ubuntu.com] - this leads to users having to search more than one place and general fragmentation of documentation.
  • There is a team of editors on the wiki (WikiTeam) but because all users have the same rights, pages occasionally get rewritten, moved and deleted in ways which create non-trivial problems.

Use cases

Scope

Design

Implementation

Code

Data preservation and migration

Outstanding issues

BoF agenda and discussion

BetterWikiDocs (last edited 2008-08-06 16:38:32 by localhost)