docs in a wiki [was Re: making review/bug filing optional for

[Luis Villa]

On Fri, 18 Mar 2005 12:26:48 -0500, David Miller <justdave at bugzilla.org> wrote:
> Luis Villa wrote:
> > Slightly OT from the developing flame war :) Why not put all the docs
> > in a wiki, leave it open, make sure someone is at least trying to
> > review the (probably low traffic) commits /after they happen/, and
> > just have a script to pull docs off the wiki and into the tarball for
> > the release?
> >
> > Hula is using this approach:
> > http://www.hula-project.org/Hula_Server
> >
> > and so far  by all accounts it is working well for them.
> 
> That's actually a pretty cool idea, except that as far as I know, wikis
> don't deal well with Docbook XML, and it would probably be non-trivial
> to convert it.

I seem to recall that at least one of the bigger wikis can accept
docbook. Not sure, though. Sadly, wiki.docbook.org is down, seems like
they'd know ;)

To keep pushing the boundaries, though- why do we use docbook? It's
great for structured text. Do we actually use that (or, do we use it
more than what the HTML markup would give us?) Does it give us
translation benefits? Offhand, I can  see an argument to be made that
the flexibility and more collaborative nature of wiki would justify
dumping docbook.

Luis