Alex Mandel wrote:
On 04/03/2010 03:52 AM, Frans Thamura wrote:
can the material also online @ osgeo.org
F
Of course they should be. I think this might highlight a slight
difference in how I'm thinking about the documentation. I was thinking a
one page short description of each project would be in html for the
live-dvd and the more detailed documentation written by the community
would be pdf generated from OpenOffice or whatever other format
educators are writing in and store in the educational inventory.
This keeps the creation and management of in depth tutorials out of the
the Live DVD builders hands and ensures the documents are in a more
general repository like the educational inventory. At build time we can
download and link the relevant tutorials into the html docs structure of
the live-dvd.
At least that's my idea on how to handle the issue.
Thanks,
Alex
Alex,
I'm happy to move some or all of the creation of documentation outside
the LiveDVD project, maybe in a sister project as part of the education
committee or similar.
But I do want to see this material getting developed, and I think us
LiveDVD packages have a formula that we can share in order to faciliate
the creating of docs.
I probably should mention that I've been thinking about generating
documentation from many sources for many years, and have even written a
documentation generation framework [1] which aggregates documentation
from numerous sources into one deliverable. It used the Docbook XML
format, which has since lost favour, and was limited because images
can't be imbedded in the document.
However, the scripts are xml based, and I understand that the OpenOffice
format is XML based, so there is a good chance we can resurect this
project for our documentation generation process:
[1] http://generguide.sourceforge.net/
--
Cameron Shorter
Geospatial Solutions Manager
Tel: +61 (0)2 8570 5050
Mob: +61 (0)419 142 254
Think Globally, Fix Locally
Geospatial Solutions enhanced with Open Standards and Open Source
http://www.lisasoft.com
_______________________________________________
Live-demo mailing list
[email protected]
http://lists.osgeo.org/mailman/listinfo/live-demo
http://wiki.osgeo.org/wiki/Live_GIS_Disc
