<div dir="ltr">Hi All,<div><br></div><div>I really appreciate the effort Andrew has gone to in documenting the experience of committing an update to the QGIS documentation. While this might be slightly outside of the scope of this Google SoD I think we should be strongly encouraging OSGeo projects to include something like this in their documentation- and it would be great to have something like this that we can perhaps offer as a template.</div><div><br></div><div>I think that the writing style was just right for new contributors- with plenty of screenshots it was easy to follow and went through each step in the process without missing anything. The only comment I would make is that it would be handy to explain the very end of the process, eg what it looks like when your contribution is accepted. Just to finish things off!</div><div><br></div><div> I went to look to see if there was anything similar for Geonetwork, and I don't think there is. @Maria and anyone else interested in improving the Geonetwork docs, could we start on this? @Maria I notice also that the "fork me on github" link in the Geonetwork documentation goes to a 404 error, which I would imagine might put anyone fairly new off making an edit!</div><div><br></div><div>In response to some of Cameron's comments (also going back to earlier in the thread)- why are people writing training material and not making it available in the core repository? From a commercial perspective it seems quite simple. If we (rhetorically, and not necessarily talking about Astun Technology here) wish to charge for training, then the training material is surely part of what we're charging for? If we use publicly available training material some people may complain that they are paying for material that is freely accessible. Personally I think we should be focusing on the manual rather than on training material as such.</div><div><br></div><div>Jo</div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, May 26, 2019 at 9:37 PM Cameron Shorter <<a href="mailto:cameron.shorter@gmail.com">cameron.shorter@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Thanks Matteo for the suggestions.<br>
<br>
I'm keen to lean on the experience of you and our community here to <br>
discuss your "How to contribute" page:<br>
<br>
<a href="https://docs.qgis.org/testing/en/docs/training_manual/appendix/contribute.html" rel="noreferrer" target="_blank">https://docs.qgis.org/testing/en/docs/training_manual/appendix/contribute.html</a><br>
<br>
* Andrew Jeffry has been a newbie QGIS documented and has helped other <br>
newbies getting started, and has collated his experience here: <br>
<a href="https://docs.google.com/document/d/1eWpqmZHFiuoUhcCPcf9VTFrs2ol53A-Ha9in8sbiwlU/edit?usp=sharing" rel="noreferrer" target="_blank">https://docs.google.com/document/d/1eWpqmZHFiuoUhcCPcf9VTFrs2ol53A-Ha9in8sbiwlU/edit?usp=sharing</a> <br>
. Matteo and Harrissou:How do you suggest we go forward with improving <br>
the getting started experience with Andrew's insights? Should we invite <br>
Andrew to update existing getting started page with his material?<br>
<br>
* The "How to contribute" page explains the mechanics of how to <br>
contribute, but where I see additional value in the SeasonOfDocs <br>
initiative is in addressing some of the meta issues. Answering questions <br>
like:<br>
<br>
** What content do we want to accept in the QGIS manual? How do we <br>
decide what is in/out?<br>
<br>
** How should each page fit within the greater documentation and <br>
learning vision?<br>
<br>
** What types of documentation do we want to create?<br>
<br>
** What is the target persona we wish to write to for each doc type?<br>
<br>
** What writing style/tone should be applied?<br>
<br>
** I'd be interested to hear Jared's thoughts from the perspective of a <br>
senior technical writer.<br>
<br>
* From the various owners of QGIS training material on this list: Why <br>
are you writing and using material outside of the core QGIS repository? <br>
What are your barriers to entry in getting back into a central location <br>
and collaborating on material development and maintenance)?<br>
<br>
<br>
On 27/5/19 3:34 am, matteo wrote:<br>
> Hi all,<br>
><br>
> concerning the Training Material of QGIS I want to share some thoughts:<br>
><br>
> It is more than welcome to add some "Use case" specific material within<br>
> the training manual. It still needs to be updated for QGIS 3 but have a<br>
> look here:<br>
><br>
> <a href="https://docs.qgis.org/testing/en/docs/training_manual/forestry/index.html" rel="noreferrer" target="_blank">https://docs.qgis.org/testing/en/docs/training_manual/forestry/index.html</a><br>
><br>
> What I'll suggest is to use some specific workflow rather than<br>
> "duplicating" some other exercise in other section.<br>
><br>
> Also we have a complete "How to add you contribution" chapter:<br>
><br>
> <a href="https://docs.qgis.org/testing/en/docs/training_manual/appendix/contribute.html" rel="noreferrer" target="_blank">https://docs.qgis.org/testing/en/docs/training_manual/appendix/contribute.html</a><br>
><br>
> where all the syntax to use is described.<br>
><br>
> We also have badges for exercises (Easy, Moderate, Hard) and a "try<br>
> yourself" where you can ask the user to make and exercise and then look<br>
> at the answer.<br>
><br>
> Normally we suggest to provide OSM data: if data are not too complex or<br>
> specific it allows the user to replicate the workflow in his/her area of<br>
> interest by downloading the data directly in QGIS with the QuickOSM<br>
> plugin (another section explains how to use it<br>
> <a href="https://docs.qgis.org/testing/en/docs/training_manual/foreword/preparing_data.html" rel="noreferrer" target="_blank">https://docs.qgis.org/testing/en/docs/training_manual/foreword/preparing_data.html</a>)<br>
><br>
> Cheers<br>
><br>
> Matteo<br>
> _______________________________________________<br>
> SeasonOfDocs mailing list<br>
> <a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank">SeasonOfDocs@lists.osgeo.org</a><br>
> <a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
<br>
-- <br>
Cameron Shorter<br>
Technology Demystifier<br>
Open Technologies and Geospatial Consultant<br>
<br>
M +61 (0) 419 142 254<br>
<br>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="gmail_signature">------------------------<br><a href="http://about.me/jocook" target="_blank">http://about.me/jocook</a></div>