Comment 6 for bug 114266

Hiya,

On 21/08/07, Phil Bull <email address hidden> wrote:
> We could probably implement most of this *today* using includes. While
> not ideal, it should work OK and I concede that it'll be less work than
> writing our own macros...

Sure, even if we need to slightly modify the behaviour of the Include
macro we can easily do so.

> An upshot of this approach is that we should be able to search for
> '[[Include(Tag/SystemDoc' and have all of the pages with that tag
> appear. Note that we have to miss off the last bracket of the search
> string because of the way Moin parses it. See
> https://wiki.ubuntu.com/Philbull, section 'Testing' at the bottom, for
> an example. We'd need to protect the Tag and Version pages from edits,
> too.

Cool, thanks for investigating this. We should consider carefully the
various categories, and then maybe we can start implementing some of
this.

> As for structure, just stick the whole ubuntu-doc tree under
> Official/$RELEASE or maybe just $RELEASE/. For example, internet.xml
> would be found at
> https://help.ubuntu.com/community/Official/Gutsy/Internet.

I don't think that is going to work. Apart from anything else, the
whole point of merging the two is so that the user doesn't have to do
battle with different information on the same topic; if we are going
to move the system docs into the wikispace I really think we need to
make an effort to eliminate overlap and do a proper merge.

However, as you point out, that may be hell to maintain unless we
elaborate a good way to do that.

We'll also have to overcome the technical issue of converting the
material to the wiki markup (in particular, the main problem there is
going to be how to control chunking so that it's possible to convert a
single docbook document to a number of wiki pages or a single wiki
page as appropriate).

--
Matthew East
http://www.mdke.org
gnupg pub 1024D/0E6B06FF