BetterWikiDocs

Differences between revisions 5 and 6
⇤ ← Revision 5 as of 2005-10-24 09:20:10 →
Size: 1608
Editor: mailgate
Comment: adding corey as second
← Revision 6 as of 2005-10-24 09:25:11 → ⇥
Size: 2483
Editor: henrik
Comment: added myself and some more detail
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
 * People: MatthewEast, CoreyBurger  * People: MatthewEast, CoreyBurger, HenrikOmma
Line 28: Line 28:
We merged the UDU wiki into the main Ubuntu wiki in August and the Edubuntu wiki followed in October. There are some benefits to having all content gathered in one place, but there are also drawback. Documentation can now be difficult to find among the Specs and community-related pages. The performance has also degraded as the number of pages and revisions have increased. We basically need to think about how we will scale.
Line 33: Line 35:
'''Options:'''
 * Split out wikis based on content (not distro) and use interwiki winks. These could run on separate machines and have separate search, but login should be managed centrally. Wiki instances might include: teams.u.c, docs.u.c, teams.u.c, specs.u.c, and wiki.u.c (I guess people.u.c is already used).
 * Look into moin development like clustering and caching techniques (non exist so far AFAIK).
Line 43: Line 48:
----
CategorySpec

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.

We merged the UDU wiki into the main Ubuntu wiki in August and the Edubuntu wiki followed in October. There are some benefits to having all content gathered in one place, but there are also drawback. Documentation can now be difficult to find among the Specs and community-related pages. The performance has also degraded as the number of pages and revisions have increased. We basically need to think about how we will scale.

Use cases

Scope

Design

Options:

  • Split out wikis based on content (not distro) and use interwiki winks. These could run on separate machines and have separate search, but login should be managed centrally. Wiki instances might include: teams.u.c, docs.u.c, teams.u.c, specs.u.c, and wiki.u.c (I guess people.u.c is already used).
  • Look into moin development like clustering and caching techniques (non exist so far AFAIK).

Implementation

Code

Data preservation and migration

Outstanding issues

BoF agenda and discussion

CategorySpec

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