<html>
<head>
</head>
<body style="margin-bottom: 1px; font-weight: normal; font-family: Comic Sans MS; font-style: normal; line-height: normal; margin-right: 4px; margin-left: 4px; font-size: 12pt; font-variant: normal; margin-top: 4px">
<p style="margin-top: 0; margin-bottom: 0">
<font size="3" face="Comic Sans MS">All,</font> </p>
<br>
<p style="margin-top: 0; margin-bottom: 0">
<font size="3" face="Comic Sans MS">One thought here, I know the end result tends to be larger files, but I've had very good success with providing flash movies of screen recordings for documentation. These seem to go over fairly well with the users, as they can start and pause during a process as they follow along.</font> </p>
<br>
<p style="margin-top: 0; margin-bottom: 0">
<font size="3" face="Comic Sans MS">bobb</font> </p>
<br>
<p style="margin-top: 0; margin-bottom: 0">
<br>
<br>
>>> Cameron Shorter <cameron.shorter@gmail.com> wrote:<br> </p>
<table style="margin-bottom: 0; margin-right: 0; margin-left: 15px; font-size: 1em; margin-top: 0" bgcolor="#f3f3f3" border="0">
<tr>
<td>
<div style="padding-left: 7px; border-left: solid 1px #050505">
<p style="margin-top: 0; margin-bottom: 0">
Thanks Simon, valuable feedback as always.<br>Comments inline ...<br><br>On 31/05/2011 3:19 PM, Simon Cropper wrote:<br>> Cameron,<br>><br>> 1) I tried over an extended period to become involved with creation of<br>> tutorials for OSGeo and gvSIG community by found the<br>> peculiar/particular ways of constructing documents were both time<br>> consuming and frustrating. I imagine this is in part the cause for so<br>> few new and on-going volunteers.<br><br>Yes, I've found programmers seem quite comfortable with our RST format<br>we have chosen for our docs, but we haven't attracted many users, and<br>some of the docs I've received, including a tech writer, sent the docs<br>to me in word format, and I needed to convert.<br><br>I'd love to be introduced to a documentation creation process which<br>makes this easier.<br><br>><br>> 2) Rather than have developers create the documents, try and have<br>> users create the documents as they have different perspectives.<br><br>I agree, but as yet found it hard to attract users. I've found that<br>users often don't feel like they know enough to write the docs. Or<br>possibly they are not as committed to their projects as the developers are.<br><br>><br>> 3) Tutorials augmented with detailed and pertinent images make it easy<br>> for the reader to follow what is going on. Extra time spent on an<br>> image pays off big in comprehension (you need more than just a course<br>> screen dump). Lines, numbering, highlights, boxes and annotations all<br>> help direct a user's focus to those areas which are important.<br><br>Excellent point. I've cut and pasted the above into our writing guide at:<br><a href="http://wiki.osgeo.org/wiki/Live_GIS_Add_Project#Screen_Shots">http://wiki.osgeo.org/wiki/Live_GIS_Add_Project#Screen_Shots</a><br><br>><br>> 4) Once off documents are OK but maintenance of a document library is<br>> the key to any good repository -- I don't think anyone has really<br>> mastered this issue yet. You need to simplify the process for<br>> contributors and people who create derivatives. No real idea how you<br>> do this. No software is available that makes this easy.<br>><br>> In regards to use of data...<br>><br>> 1) Tutorials / Static documents should use the 1-2 standard datasets<br>> you discussed.<br>><br>> 2) Live demonstrations at the conference should endeavour to use local<br>> datasets if suitable information is available. If possible these<br>> 'workshops' or 'demos' should be captured as videos.<br>><br><br><br>--<br>Cameron Shorter<br>Geospatial Solutions Manager<br>Tel: +61 (0)2 8570 5050<br>Mob: +61 (0)419 142 254<br><br>Think Globally, Fix Locally<br>Geospatial Solutions enhanced with Open Standards and Open Source<br><a href="http://www.lisasoft.com">http://www.lisasoft.com</a><br><br>_______________________________________________<br>Live-demo mailing list<br>Live-demo@lists.osgeo.org<br><a href="http://lists.osgeo.org/mailman/listinfo/live-demo">http://lists.osgeo.org/mailman/listinfo/live-demo</a><br><a href="http://wiki.osgeo.org/wiki/Live_GIS_Disc">http://wiki.osgeo.org/wiki/Live_GIS_Disc</a><br>
</p>
</div>
</td>
</tr>
</table>
</body>
</html>