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

[matteo]

Hi Jared,

> It's great that you are raising these concerns, Matteo. 
> 
> I wanted to pose this question to reveal some of the feelings around the
> processes that are currently in place.
> 
> You are correct in that to use git-flow you do need desktop software
> installed like Sourcetree.

that's what is scaring me: relying to more and more software and making
things more complicated.

> Here's an interesting question to pose. If you could suggest your ideal
> way of getting folks to contribute, what would that look like?

that's a good question. IMHO there could be different ways to contribute:

* Wikipedia style: finding a typo or updating a small sentences. You log
in and there you go. Some reviewer will take care of the quality but you
as contributor don't have to think at the framework
* more complex contributions (adding a whole section...): you know what
you what to add, but you couldn't be a "developer" and you are afraid of
git/github....
* same as above but you are not scared.

This lead to 2 different routes:

* first case you are a spot contributor willing to enhance the
documentation (e.g. native English speaker with poor (Q)GIS knowledge)
* second case: in some way you have to be in touch with the community
(thing that I always suggest of course), by asking questions, being
collaborative and discover that we are normal people and not robots to
be afraid of :)

bot routes are difficult: what we are missing now is the spot
contributor while harvesting new "core" contributors is hard. But we are
doing our best during HackFests and other events

> Apologies for not being specific enough here. What I'm curious about is
> whether we have any overarching learning goals that we would like users
> to get out of existing training modules.
> 
> And, if the goals are different for new modules, what would those
> learning goals be.
> 
> I will be open with you all here: I've not got much experience with
> training material creation. It's something I'd like to learn more about
> and I think I'm in the right project to get this knowledge.

well I think goals could be very different here. You can think to a
complete newbie of QGIS or to a normal user that is improving his/her
skills  with some specific examples (e.g. geological data). So I'd say
to look at 360°

> That is my initial suggestion. But it only makes sense to do this if it
> adds value to the existing content.
> 
> For example, if we make the content more atomic, will this help the
> project remix the docs into user manuals?
> 
> The goal is to reduce the work in producing user guides *and* training
> materials. Essentially it boils down to "write it once, use it twice".

I get it but refactoring a complex framework like the QGIS doc requires
a bit of coordination :)

Thanks for all the suggestions

Matteo