<div dir="ltr"><div class="gmail_default" style="color:#0000ff">I agree that it is a good list (thanks Cameron for starting this). I've added one more point, and suggested a bit of word-smithing (explanatory notes below):<br></div><div class="gmail_quote"><div dir="ltr"><div style="color:#0000ff"><br></div><div style="color:#0000ff"><p style="color:rgb(49,49,49);word-spacing:1px"><i style="font-size:1rem"><span class="gmail_default" style="color:rgb(0,0,255)"></span>* Clear and intuitive documentation<span class="gmail_default" style="color:rgb(0,0,255)">;</span><span class="gmail_default" style="color:rgb(0,0,255)"></span></i></p><p style="color:rgb(49,49,49);word-spacing:1px"><i style="font-size:1rem">* <span class="gmail_default" style="color:rgb(0,0,255)">C</span></i><i><span style="font-size:1rem">over<span class="gmail_default" style="color:rgb(0,0,255)">ing</span> the <span class="gmail_default" style="color:rgb(0,0,255)">evolving </span>breadth of <span class="gmail_default" style="color:rgb(0,0,255)">OS</span>Geo <span class="gmail_default" style="color:rgb(0,0,255)">software;</span></span></i></p><p style="color:rgb(49,49,49);word-spacing:1px"><i style="font-size:1rem"><span class="gmail_default" style="color:rgb(0,0,255)">* Structured to meet the diverse needs of the OSGeo community;</span></i></p><p style="color:rgb(49,49,49);word-spacing:1px"><i style="font-size:1rem">*</i><i><span style="font-size:1rem"> <span class="gmail_default" style="color:rgb(0,0,255)">Designed to invite and facilitate user contributions; and</span> </span><br></i></p><p style="color:rgb(49,49,49);word-spacing:1px"><i><span style="font-size:1rem"><span class="gmail_default" style="color:rgb(0,0,255)">* Linking to relevant external learning resources</span></span></i></p><p style="color:rgb(49,49,49);word-spacing:1px"><span style="font-size:1rem"><i>* ... and what else ??? </i></span></p></div><div style="color:#0000ff"><u>Notes</u></div><div style="color:#0000ff">Replaced "QGIS and GeoNetwork" with "OSGeo" as it is succinct and enduring (evolving)</div><div style="color:#0000ff"><br></div><div style="color:#0000ff">Added "community" (but kept "user" on the next line) as it is broader and reflects core OSGeo values (that we want to promote?)</div><div style="color:#0000ff"><br></div><div style="color:#0000ff">"Structured" (could be designed?) meaning not just the writing style, but also including consideration of how different resource types integrate (manuals, tutorials, etc.)</div><div style="color:#0000ff"><br></div><div style="color:#0000ff">"Invite and facilitate" -- a bit more expansive than "lowers the barrier"?<i> (e.g., would it be possible/desirable to allow comments at the bottom of doc pages, thereby inviting and facilitating minimal effort contributions, in real time, that could be edited/incorporated as docs are revised?)</i></div><div style="color:#0000ff"><br></div><div style="color:#0000ff">"Linking..." to pick up my earlier comments about the potential to consider how official documentation can complement/integrate with other resources.<span class="gmail_default" style="color:rgb(0,0,255)"> May be too ambitious, but worth considering at this stage?</span></div><div style="color:#0000ff"><br></div><div><div dir="ltr" class="m_-5183644679050093003gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><font color="#0000ff">Cheers, Brian</font></div><div><font color="#0000ff"><br></font></div><div><font color="#0000ff">0411-659-430</font></div><div><font color="#0000ff"><br></font></div><font color="#0000ff"><a href="http://linkedin.com/in/bpmcrae" target="_blank"><img src="https://docs.google.com/uc?export=download&id=0B7LTGZZTlaGZd242QkJhQjNNZVE&revid=0B7LTGZZTlaGZeFNvajduN1hFdzYvbmJReEVSd0RIT3VHYkxnPQ"></a></font><br></div></div></div><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, 1 Jun 2019 at 08:43, Jared Morgan <<a href="mailto:jaredleonmorgan@gmail.com" target="_blank">jaredleonmorgan@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"><div dir="auto">Yep I agree. Getting this right is super important.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri., 31 May 2019, 19:22 Jo Cook, <<a href="mailto:jo.k.cook@gmail.com" target="_blank">jo.k.cook@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"><div dir="ltr">As a further vision for the overarching Google Season of Docs project, I would like to add:<div><br></div><div>"Lowering the barriers for users to contribute to documentation"</div><div><br></div><div>Thanks</div><div><br></div><div>Jo</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, May 30, 2019 at 9:39 PM Cameron Shorter <<a href="mailto:cameron.shorter@gmail.com" rel="noreferrer" target="_blank">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">
<div bgcolor="#FFFFFF">
<p>Our email thread has covered multiple topics, so I've changed the
title and am focusing here just on the question of "Vision":<br>
</p>
<div class="m_-5183644679050093003gmail-m_7670733169310096506m_1730989046271261269gmail-m_7114044370894234076moz-cite-prefix">On 30/5/19 10:00 pm, Jared Morgan
wrote:<br>
</div>
<blockquote type="cite">
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">>
Jared Morgan wrote: Do we have a learning vision defined for the
project? Where would I<br>
> find this?<br>
<br>
Matteo wrote: what do you mean exactly here? The type of
contribution an user wants to<br>
add?<br>
</blockquote>
<div><br>
</div>
<div>Jared Morgan wrote: 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.<br>
<br>
And, if the goals are different for new modules, what would
those learning goals be.</div>
<div><br>
</div>
<div>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.</div>
</blockquote>
<p>Great question Jared. Research [1] [2] into open source has
identified success metrics to include: <i>"vision" and
"opportunity to identify alignment with the community"</i>.</p>
<p>Defining a vision is harder than asking. As we don't seem to have
a ready answer yet, I suspect we either haven't articulated our
vision, or we have room to improve it.<br>
</p>
<p>I was hoping to cut-and-paste a clear vision from our OSGeoLive
home page, but it appears we have work to do as our vision is
spread across multiple places. <br>
</p>
<p><i>OSGeoLive is a self-contained bootable USB or Virtual Machine
based on the Lubuntu Linux distribution, that is pre-installed
and pre-configured with over 50 of the best GeoSpatial Open
Source applications along with sample datasets. It contains
clear and consistent Overviews and Quickstarts for each
application. This allows people to quickly learn the breadth of
OSGeo software, and is regularly used in workshops and training
sessions or is being handed out at conferences.</i></p>
<p>What is our vision for QGIS and GeoNetwork documentation and this
Season of Docs initiative? Maybe:</p>
<p><i>* Clear and intuitive documentation</i></p>
<p><i>* Which addresses our key user groups (defined as ???)</i></p>
<p><i>* Which covers the breadth of rapidly innovating QGIS and
GeoNetwork software </i><i><br>
</i></p>
<p><i>* ... and what else ??? </i><br>
</p>
<p>[1]
<a class="m_-5183644679050093003gmail-m_7670733169310096506m_1730989046271261269gmail-m_7114044370894234076moz-txt-link-freetext" href="http://cameronshorter.blogspot.com/2018/11/comprehensive-research-into-open-source.html" rel="noreferrer" target="_blank">http://cameronshorter.blogspot.com/2018/11/comprehensive-research-into-open-source.html</a>
<br>
</p>
<p>[2] <a href="https://cameronshorter.blogspot.com/2018/12/catching-elusive-episodic-volunteer.html" rel="noreferrer" target="_blank">https://cameronshorter.blogspot.com/2018/12/catching-elusive-episodic-volunteer.html</a></p>
<pre class="m_-5183644679050093003gmail-m_7670733169310096506m_1730989046271261269gmail-m_7114044370894234076moz-signature" cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</div>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" rel="noreferrer" target="_blank">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer 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="m_-5183644679050093003gmail-m_7670733169310096506m_1730989046271261269gmail_signature">------------------------<br><a href="http://about.me/jocook" rel="noreferrer" target="_blank">http://about.me/jocook</a></div>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" rel="noreferrer" target="_blank">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote></div>
_______________________________________________<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>
</div></div>