[OSGeo-Edu] Re: [Live-demo] Creating OSgeo training material as part of the OSGeo Live DVD

[Cameron Shorter]

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