Publishing good wiki docs in the distribution

Matthew East mdke at ubuntu.com
Mon Jan 23 14:11:15 UTC 2006


I'd like to raise something for discussion: is it desirable for us to
ship individual wiki pages as guides in the distribution. 

The technical barriers to this have been slightly lowered with the
release of Moin 1.5 (thanks to mhz for reminding me of this). What is
necessary is:

Put a wiki page in a Moin 1.5 wiki (such as a personal desktop version),
use the "render in xml" tool, then put the output in a file and tidy it
up using the validation tool in our repository.

The more difficult question is how we might wish to release these
guides. Releasing them individually is an option, we could either (i)
include them in the list of Ubuntu specific documents on the frontpage,
(ii) make an Ubuntu subcategory on the frontpage, or (iii) attempt to
integrate them with the current categories (Desktop, Applications, Other
Documentation). I don't know what the most effective way of doing this
is, obviously it would in part depend on the wiki guide. Another tricky
question is to ensure that they are effectively integrated with the
longer guides which we ship (server/desktop)

Any ideas/thoughts on this? It would be really nice to have some of the
more comprehensive and useful guides in the distribution as well as on
the wiki.

Matt
-- 
mdke at ubuntu.com
gnupg pub 1024D/0E6B06FF
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060123/7945872a/attachment.pgp>


More information about the ubuntu-doc mailing list