Reorganize MOTU team documentation?
Benjamin Drung
bdrung at ubuntu.com
Mon Mar 1 15:43:31 GMT 2010
Am Montag, den 01.03.2010, 16:37 +0100 schrieb Morten Kjeldgaard:
> I have to admit it: I hate the wiki. While it is very, very, very easy
> to add new and quite good looking documentation, it is nearly
> impossible to maintain, let alone get an overview of what is available
> and what state it is in.
Exactly.
> In its current state, the Wiki contains loads of grossly out-of-date
> information.
>
> Now, in connection with the reorganization of the MOTU team, I propose
> that all the MOTU team documentation gradually be moved into Mallard
> format in an ordinary directory tree, living in a bzr branch owned by
> our team on LaunchPad.
>
> We could translate the docs into HTML pages that could be packaged and
> distributed, and thus installable by everyone on their own machine.
> The documentation should also be hosted somewhere ... possibly at
> motu.ubuntu.com? Having the documentation in an DVCS, every instance
> of it would have a version number that could be referenced, there
> would be a history feed for the documentation as a whole (not just
> individual pages, like the wiki has) and there would be a valid
> version of the documentation matching each release of *ubuntu.
>
> Updating, searching, and maintaining the documentation (i.e. packaging
> guides, tutorials etc.) would be much easier, and the same is true for
> translations of the same.
+1 Having the documentation in a DVCS accessible by all MOTU is a good
idea.
--
Benjamin Drung
Ubuntu Developer (www.ubuntu.com) | Debian Maintainer (www.debian.org)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 835 bytes
Desc: Dies ist ein digital signierter Nachrichtenteil
Url : https://lists.ubuntu.com/archives/ubuntu-motu/attachments/20100301/b831e038/attachment.pgp
More information about the Ubuntu-motu
mailing list