[Live-demo] Creating OSgeo training material as part of the OSGeo Live DVD
cameron.shorter at gmail.com
Sat Apr 3 13:51:51 PDT 2010
Alex Mandel wrote:
> On 04/03/2010 03:52 AM, Frans Thamura wrote:
>> can the material also online @ osgeo.org
> 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.
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  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:
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
More information about the Osgeolive