[Koha-devel] Koha Documentation Structure

[Anthony Youngman]

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 at lists.sourceforge.net
[mailto:koha-devel-admin at lists.sourceforge.net] On Behalf Of Joshua
Ferraro
Sent: 04 October 2004 15:15
To: koha-devel at lists.sourceforge.net
Subject: Re: [Koha-devel] Koha Documentation Structure

On Mon, Oct 04, 2004 at 02:39:49PM +0100, MJ Ray wrote:
> 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 
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 at 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.

****************************************************************************