[maemo-community] The role of the docmaster

[From: Murray Cumming]

On Mon, 2009-05-25 at 21:34 +0200, Dave Neary wrote:
> Murray Cumming wrote:
> > 1.
> > Get a library.maemo.org up and running ASAP, like library.gnome.org.
> It
> > would use mostly just published source tarballs.
> 
> ...
> 
> > 2.
> > Get the Nokia documentation people to use standard tools, such as
> > DocBook XML, instead of half-generating stuff and then editing the
> HTML.
> 
> ...
> 
> (Just to point out that 2 would have to happen before 1)
[snip]

Well, the API reference documentation is mostly already using gtk-doc,
which is sane and ready for use by library.gnome.org, so that would
already partly solve the problem of different versions of the same
documentation jumping around different URL pattersn.

And once you have that working, I think it might be more persuasive than
any attempt to explain why a sane process would be sane. Momentum seems
to be the problem here so it might help to have some momentum in a
sensible direction.
 
-- 
murrayc at murrayc.com
www.murrayc.com
www.openismus.com