[Live-demo] What writing and maintenance guidelines should be applied to OSGeo Training material?

Jeremy Morley Jeremy.Morley at nottingham.ac.uk
Mon Apr 29 16:05:39 PDT 2013


This is doubly timely: the next phase of funding we have for ELOGeo will particularly look at "community curation" tools, e.g. to help deprecate old material.

We also hope to integrate some on-line learning material using the Xerte open source toolkit (also developed in Nottingham).

We're open to suggestion though in this, and hope to be able to run a side workshop at FOSS4G in Nottingham to present ideas for feedback and discussion. I hope our work will really kick off in May/June (some discussion needed with our funders, JISC, about the project plan first).


-- ------------------------------------------------------------ --
Jeremy Morley
Geospatial Science Theme Leader, Nottingham Geospatial Institute,
Triumph Road, University of Nottingham. NG7 2TU, United Kingdom.
Web:   http://www.nottingham.ac.uk/ngi     Twitter: jeremy_morley
Tel.:  +44/0 115 84 68411
Email: jeremy.morley at nottingham.ac.uk

From: Cameron Shorter <cameron.shorter at gmail.com<mailto:cameron.shorter at gmail.com>>
Date: 29 April 2013 23:59
To: Lluís Vicens <lluis at sigte.udg.es<mailto:lluis at sigte.udg.es>>
Cc: Jeremy Morley <jeremy.morley at nottingham.ac.uk<mailto:jeremy.morley at nottingham.ac.uk>>, "ica-osgeo-labs at lists.osgeo.org<mailto:ica-osgeo-labs at lists.osgeo.org>" <ica-osgeo-labs at lists.osgeo.org<mailto:ica-osgeo-labs at lists.osgeo.org>>, "live-demo at lists.osgeo.org<mailto:live-demo at lists.osgeo.org>" <live-demo at lists.osgeo.org<mailto:live-demo at lists.osgeo.org>>
Subject: Re: What writing and maintenance guidelines should be applied to OSGeo Training material?

It is great to hear that we have free training material seeding the ELOGeo repository.
I think the next step is to work out writing and maintenance guidelines which can be applied to ensure a consistent, and up-to-date level of quality across all training material.

Once this is in place, it will make it much easier for the community to develop and maintain our documentation.

So questions I'd like to ask workshop authors are:

* Are there any examples or best practices in place for outlining the structure of a training course? (I'm looking for something similar to our OSGeo-Live documentation processes here: http://wiki.osgeo.org/wiki/Live_GIS_Add_Project#Documentation )

* How can we collect and then incorporate user feedback on the documentation? I like how the Postgres documentation allows users to "Add Comment" to each page:

* What technologies should we be using to create the documentation? For OSGeo-Live we use RST and subversion. I'd be interested to hear whether this is a technical barrier for tutors, and maybe we should be adopting a CMS, or wiki, or open office, or ...

On 29/04/2013 6:11 PM, Lluís Vicens wrote:
Al 27/04/13 23:01, En/na Jeremy Morley ha escrit:

Dear Cameron,

As a contributor to the Summer School, I'd certainly be happy to contribute material from that to the Live DVD. As I recall, at least some of the material is in ELOGeo under a CC-by-SA licence but of content is updated each year. We have some funding to do some more work on ELOGeo this year, and I plan to convert my course material based on the OSGeo Live USB system to content in ELOGeo. This might serve both purposes. Happy to discuss further.


Dear Cameron, as Jeremy points out, all the documentation used as training material during the previous editions of the summer school [1][2][3], are freely available for download in the summer school website as well as from the ELOGeo[4] repository under a creative commons license. Using this material as a starting point for educational material related to OSGeo-Live sounds good. Do you think that a CC-By-SA is a proper license for this kind of material?


[1] http://www.sigte.udg.edu/summerschool2010/Materials
[2] http://www.sigte.udg.edu/summerschool2011/programme/Materials
[3] http://www.sigte.udg.edu/summerschool2012/Materials
[4] http://elogeo.nottingham.ac.uk/

Lluís Vicens

SIGTE - Universitat de Girona
Pl. Ferrater Mora, 1
17071   Girona

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

This message and any attachment are intended solely for the addressee and may contain confidential information. If you have received this message in error, please send it back to me, and immediately delete it.   Please do not use, copy or disclose the information contained in this message or in any attachment.  Any views or opinions expressed by the author of this email do not necessarily reflect the views of the University of Nottingham.

This message has been checked for viruses but the contents of an attachment

may still contain software viruses which could damage your computer system:

you are advised to perform your own checks. Email communications with the

University of Nottingham may be monitored as permitted by UK legislation.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/osgeolive/attachments/20130430/2aef9731/attachment.html>

More information about the Osgeolive mailing list