RE: [Koha-devel] Koha Documentation Structure
froody... If you want CC, use that one ;-) Free software needs free software manuals. However, I do think we should at least consider the possibility of a
Take a look at some of the O'Reilly books. I don't know how many of them are "Free" books that they have taken off the net, but there are a fair few where O'Reilly includes the source of the book and is not able to stop users copying the text. I thought DocBook was one of these but I'm not sure. If you want a "publisher friendly" licence, contact O'Reilly and ask them. As for all the documentation "being XML" and someone pointing out that XML is more a meta-format than a format, I would say that you should use DocBook for the documentation. I seem to remember hearing something about DocBook being updated recently, but it is a structured markup language, I think it does have an XML DTD, and it's pretty much the standard for Free Software documentation (the master copy, at least). The nice thing about it is that all the scripts, programs and everything are all there so that you can convert it into a help file, an html manual, a print manual, whatever. And if a publisher should decide it's worth printing, it's in a nice, convenient, STANDARD form for them to just drop into their system and run with ... Cheers, Wol -----Original Message----- From: koha-devel-admin@lists.sourceforge.net [mailto:koha-devel-admin@lists.sourceforge.net] On Behalf Of Joshua Ferraro Sent: 04 October 2004 15:15 To: koha-devel@lists.sourceforge.net Subject: Re: [Koha-devel] Koha Documentation Structure On Mon, Oct 04, 2004 at 02:39:49PM +0100, MJ Ray wrote: printed manual at some time in the future. So which license is likely not to prevent a publisher from signing on? Or would we self-publish? Joshua ------------------------------------------------------- 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 **************************************************************************** This transmission is intended for the named recipient only. It may contain private and confidential information. If this has come to you in error you must not act on anything disclosed in it, nor must you copy it, modify it, disseminate it in any way, or show it to anyone. Please e-mail the sender to inform us of the transmission error or telephone ECA International immediately and delete the e-mail from your information system. Telephone numbers for ECA International offices are: Sydney +61 (0)2 8272 5300, Hong Kong + 852 2121 2388, London +44 (0)20 7351 5000 and New York +1 212 582 2333. ****************************************************************************
participants (1)
-
Anthony Youngman