[Koha-devel] Thoughts on documentation -- please feedback

[Stephen Hedges]

Hello, all -

I have been looking more closely at formats for the Koha documentation,
and I like the Simplified DocBook DTD for our XML sources
(http://www.docbook.org/xml/simple).  It seems to me that the sdocbook.dtd
has all the elements we are likely to need for the component documents
people write about Koha.

An example of an XML source tree that uses the DocBook XML DTD is the
Linux Documentation Project's template for authors
(http://www.tldp.org/authors/template/Sample-HOWTO.xml).  I think this
might also make a good template for the individual Koha documentation
components.

I also looked through the DocBook wiki section on XML tools
(http://wiki.docbook.org/topic/DocBookAuthoringTools), and looked a little
at XXE Standard Edition from xmlmind.com.  It's not open source, but it
doesn't cost anything.  I may download it and try it out.

Has anyone used XXE SE?  Anyone have any thoughts about the sdocbook.dtd
or the LDP template?

Stephen


-- 
Stephen Hedges
Skemotah Solutions, USA
www.skemotah.com  --  shedges at skemotah.com