Re: [Exist-development] eXist documentation rework

[Adam R. <ad...@ex...>]

> 1. How is this issue of CSS and the "new design" related to the
> project to revise documentation?  (I'm not saying there should be no
> overlap - perhaps this makes perfect sense to do before the
> documentation review begins.  I just haven't seen anyone explain why
> it suddenly came up here in the thread about documentation.)

Its not related. The documentation should be done first, it is
completely distinct from the design.

> 2. Is the discussion about documentation going on here in
> exist-development or off-list?  I think it's best to keep important
> matters discussed in the list, otherwise people will miss important
> details.  In keeping with that, let me suggest that google docs are
> sent out shouldn't be closed to a group but should be open to all,
> with notifications about them here.

Should be mostly here.


I also found this very good example of how docbook can be used to
produce well structured documentation -

Explanation of their docbook construction and rules -
http://anonsvn.jboss.org/repos/hibernate/core/trunk/documentation/manual/README

Docbook build to produce, html one page, html seperate pages and pdf,
in multiple languages -
http://anonsvn.jboss.org/repos/hibernate/core/trunk/documentation/manual/pom.xml

Actual docbook files -
http://anonsvn.jboss.org/repos/hibernate/core/trunk/documentation/manual/src/main/docbook/en-US/



-- 
Adam Retter

eXist Developer
{ United Kingdom }
ad...@ex...
irc://irc.freenode.net/existdb