Thoughts on documentation -- please feedback
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@skemotah.com
On 2004-10-10 00:44:35 +0100 Stephen Hedges <shedges@skemotah.com> wrote:
(http://www.tldp.org/authors/template/Sample-HOWTO.xml). I think this might also make a good template for the individual Koha documentation components.
Will that mean all koha manuals under the GNU FDL? That would suck :-( Can't we clean-room them, or base a template on the half-finished XML conversion I did of a koha manual once? gopher://g.towers.org.uk/0/papers/computing/manuals/kohadoc.xml (or replace gopher with http and remove the 0). -- MJR/slef My Opinion Only and not of any group I know Creative copyleft computing - http://www.ttllp.co.uk/ Speaking at ESF on Sat 16 Oct - http://www.affs.org.uk/
MJ, in the link you gave it looks like there's no license language, just a copyright statement and a disclaimer -- right? BTW, I grabbed a copy of this and would like to use it later, once we have the license issue resolved. :-) Stephen MJ Ray said:
On 2004-10-10 00:44:35 +0100 Stephen Hedges <shedges@skemotah.com> wrote:
(http://www.tldp.org/authors/template/Sample-HOWTO.xml). I think this might also make a good template for the individual Koha documentation components.
Will that mean all koha manuals under the GNU FDL? That would suck :-( Can't we clean-room them, or base a template on the half-finished XML conversion I did of a koha manual once? gopher://g.towers.org.uk/0/papers/computing/manuals/kohadoc.xml (or replace gopher with http and remove the 0).
-- MJR/slef My Opinion Only and not of any group I know Creative copyleft computing - http://www.ttllp.co.uk/ Speaking at ESF on Sat 16 Oct - http://www.affs.org.uk/
------------------------------------------------------- This SF.net email is sponsored by: IT Product Guide on ITManagersJournal Use IT products in your business? Tell us what you think of them. Give us Your Opinions, Get Free ThinkGeek Gift Certificates! Click to find out more http://productguide.itmanagersjournal.com/guidepromo.tmpl _______________________________________________ Koha-devel mailing list Koha-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/koha-devel
-- Stephen Hedges Skemotah Solutions, USA www.skemotah.com -- shedges@skemotah.com
On 2004-10-12 22:22:09 +0100 Stephen Hedges <shedges@skemotah.com> wrote:
MJ, in the link you gave it looks like there's no license language, just a copyright statement and a disclaimer -- right?
Yes, that's right: it's incomplete. It seems to be under the LDP v2 licence, but there seems to be an MIT/X11-like statement in there too. Ask nsr whether it can be GPLd or MIT/X11d, perhaps? I disclaim any copyright interest I might have in the markup conversion or annotations. Treat that as @nticopyright. -- MJR/slef My Opinion Only and not of any group I know Creative copyleft computing - http://www.ttllp.co.uk/ Speaking at ESF on Sat 16 Oct - http://www.affs.org.uk/
participants (2)
-
MJ Ray -
Stephen Hedges