[SeasonOfDocs] How should we focus OSGeo training within SeasonOfDocs?

[Cameron Shorter]

Hi Maria,

Great to hear your commitment and availability.

Yes, many of the volunteers signing up have a QGIS focus - although many 
also have a broader OSGeo interest. Notably, Johanna Botman, Jo Cook and 
yourself have noted a preference to work with GeoNetwork which is great.

I suspect our primary focus will be to build an approach to 
documentation, which we develop initially for one project (say QGIS), 
then test with another (say GeoNetwork), and collate our experience into 
best practices that can be applied across OSGeo (with the help of 
OSGeoLive) and the greater Open Source community.

The exact focus of our initiative will depend upon what we collectively 
decide in this email list, once people start talking. (Nudge, nudge, 
hint, hint.)

Warm regards, Cameron

On 22/5/19 6:54 pm, María Arias de Reyna wrote:
> Hi,
>
> I see many of your emails are very QGIS focused. Does this mean we 
> decided to focus on QGIS and forget about the other projects?
>
> All writers interested or assigned to GeoNetwork[1] can reach me or Jo 
> and we can help them start and take tasks. But I am not sure I will be 
> useful on other projects like QGIS.
>
> [1] https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#GeoNetwork
>
> Cheers,
> María.
>
> On Sun, May 19, 2019 at 1:18 AM Cameron Shorter 
> <cameron.shorter at gmail.com <mailto:cameron.shorter at gmail.com>> wrote:
>
>     OSGeo Season of Docs folks, (BCCed to a few potential collaborators),
>
>     As you know, the OSGeo Foundation will be allocated 1 paid
>     technical writer, for equivalent of ~ 3 months (probably spread
>     over 6), as part of Google's commitment to Season of Docs [0].
>
>     But more valuable are the 18+ serious volunteers (on this list)
>     wanting to be involved, and 5+ QGIS training material baselines
>     that we can potentially build upon. [1] I'm hoping to discuss
>     these baselines within this email thread and build a collaborative
>     vision which focuses our Season of Docs direction.
>
>     (Chris, Ori, Scott from Uni of NSW), Charlie from Uni of
>     Massachusetts, Piers from Gaia Resources, Jo from Austun
>     Technology, Matteo from QGIS docs, Nick from Uni College of
>     London, Phil from GeoAcademy: You all have mentioned training
>     material that you might be able to access. I'm hoping you might
>     restate your ideas here. (Cut and paste from before is fine).
>
>     My observations so far (based on input so far):
>
>     * We have multiple offers of material to start from, but less
>     interest in building from someone else's material.
>
>     * We all find it hard to sustain the maintenance of material,
>     acknowledging the rapid innovation of QGIS (and other OSGeo
>     projects). We'd all love external help updating our material.
>
>     * We are all concerned about the free-rider problem. We are
>     mindful that collaborators in material development are potential
>     competitors for students (and hence funding). Our organisation's
>     reputation is an important part of this story.
>
>     * We need to balance generic content that is easy to maintain
>     versus use case specific training for targeted customers.
>     (Especially important around local maps and datums used).
>
>     * It seems like there is core functionality that we can probably
>     all agree to use as a starting point for collaboration. What is
>     it? This might be our best pilot focus area.
>
>     * We could also define a best practices formula for building
>     training material that we all adopt, addressing structure, writing
>     style, etc. This is something a senior technical writer could
>     define, (and could be extended to other OSGeo projects and to the
>     greater Open Source community). This would help students who are
>     progressing through multiple training courses as they'd become
>     familiar with writing styles. Would you be prepared to adopt such
>     a guide (assuming it is better than what you already have)?
>
>     * We'll need to agree on a license that everyone can use, probably
>     Creative Commons by Attribution.
>
>     So for those of you wanting to collaborate around training
>     material - how can we help you do that? How can you help others?
>
>     [0]
>     https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Leveraging_Google.E2.80.99s_Season-of-Docs
>
>     [1]
>     https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Interested.3F
>
-- 
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant

M +61 (0) 419 142 254

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190523/40932173/attachment.html>