<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>Jared,</p>
<p>I like your idea of putting the vision into a wiki page. Maybe
the vision can be the first heading on the wiki page. The rest of
the page can collate further status and artifacts as we continue.
(You can link the new page from <a
href="https://wiki.osgeo.org/wiki/Season_Of_Docs_2019">https://wiki.osgeo.org/wiki/Season_Of_Docs_2019
</a>) Feel free to set it up.<br>
</p>
<p>Cheers, Cameron<br>
</p>
<div class="moz-cite-prefix">On 3/6/19 9:39 pm, Jared Morgan wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAFCxV179Tvq1JYAkkizgW2zFsMHD-Mxp=FKPG+tv8QoicPTEpw@mail.gmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<div dir="ltr">
<div>I think we're at the point where we can formalise this and
put it somewhere prominent.</div>
<div><br>
</div>
<div>We can always refine it further if we need to outside of
this list.</div>
<div><br>
</div>
<div>But until it's published somewhere off-list, it doesn't
really exist. <br>
</div>
<div><br>
</div>
<div>Should this be it's own Wiki page? </div>
<div><br>
</div>
<div>Should this be part of the Summer of Docs page (that page
is getting rather long now)?</div>
<div><br>
</div>
<div>What do you all think feels right?</div>
<div><br>
</div>
<div>
<div>
<div dir="ltr" class="gmail_signature"
data-smartmail="gmail_signature">
<div dir="ltr">
<div>
<div dir="ltr">Jared Morgan
<div>M: +61413005479</div>
<div><a
href="https://plus.google.com/u/0/117309635670089895654/posts/p/pub"
target="_blank" moz-do-not-send="true">Google+</a> | <a
href="http://twitter.com/!#/jaredmorgs"
target="_blank" moz-do-not-send="true">Twitter</a> | <a
href="http://facebook.com/jaredmorgs"
target="_blank" moz-do-not-send="true">Facebook</a></div>
<div><br>
</div>
<div><br>
</div>
</div>
</div>
</div>
</div>
</div>
<br>
</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Sun, 2 Jun 2019 at 12:20,
Christopher Pettit <<a href="mailto:c.pettit@unsw.edu.au"
moz-do-not-send="true">c.pettit@unsw.edu.au</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 lang="EN-US">
<div class="gmail-m_2525660176468897374WordSection1">
<p class="MsoNormal">Hi All</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">My suggestions below are in green</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">Regards</p>
<p class="MsoNormal"><br>
Chris</p>
<p class="MsoNormal"> </p>
<p class="gmail-m_2525660176468897374MsoNormalCxSpMiddle"
style="margin-left:1.7pt">
<b><i><span
style="font-size:9pt;font-family:Arial,sans-serif;color:black">Chris
Pettit</span></i></b></p>
<p class="gmail-m_2525660176468897374MsoNormalCxSpMiddle"
style="margin-left:1.7pt">
<b><i><span
style="font-size:9pt;font-family:Arial,sans-serif;color:black">Professor
of Urban Science</span></i></b></p>
<p class="gmail-m_2525660176468897374MsoNormalCxSpMiddle"
style="margin-left:1.7pt">
<i><span
style="font-size:9pt;font-family:Arial,sans-serif;color:black">Director,
City Analytics
</span></i></p>
<p class="MsoNormal"> </p>
<p class="MsoNormal"> </p>
<p class="MsoNormal"><b>From:</b> SeasonOfDocs <<a
href="mailto:seasonofdocs-bounces@lists.osgeo.org"
target="_blank" moz-do-not-send="true">seasonofdocs-bounces@lists.osgeo.org</a>>
<b>On Behalf Of </b>Brian McRae<br>
<b>Sent:</b> Saturday, June 1, 2019 12:54 PM<br>
<b>To:</b> <a
href="mailto:seasonofdocs@lists.osgeo.org"
target="_blank" moz-do-not-send="true">seasonofdocs@lists.osgeo.org</a><br>
<b>Subject:</b> [SeasonOfDocs] Fwd: What is our vision?</p>
<p class="MsoNormal"> </p>
<div>
<div>
<p class="MsoNormal"><span style="color:blue">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):</span></p>
</div>
<div>
<div>
<div>
<p class="MsoNormal"><span style="color:blue"> </span></p>
</div>
<div>
<p style="word-spacing:1px"><span
style="color:rgb(56,87,35)">* quick and simple
procedures for contributors to add content;</span></p>
<p><span
class="gmail-m_2525660176468897374gmaildefault"><i><span
style="color:rgb(56,87,35)">* high level
of visibility and recognition for
contributors;</span><span
style="color:rgb(56,87,35)"></span></i></span></p>
<p><i><span style="color:rgb(49,49,49)">* Clear
and intuitive documentation</span><span
class="gmail-m_2525660176468897374gmaildefault"><span
style="color:blue">;</span></span></i></p>
<p style="word-spacing:1px"><i><span
style="color:rgb(49,49,49)">* </span><span
class="gmail-m_2525660176468897374gmaildefault"><span
style="color:blue">C</span></span><span
style="color:rgb(49,49,49)">over</span><span
class="gmail-m_2525660176468897374gmaildefault"><span style="color:blue">ing</span></span><span
style="color:rgb(49,49,49)"> the </span><span
class="gmail-m_2525660176468897374gmaildefault"><span style="color:blue">evolving
</span></span><span
style="color:rgb(49,49,49)">breadth of </span><span
class="gmail-m_2525660176468897374gmaildefault"><span style="color:blue">OS</span></span><span
style="color:rgb(49,49,49)">Geo </span><span
class="gmail-m_2525660176468897374gmaildefault"><span style="color:blue">software;</span></span></i><span
style="color:rgb(49,49,49)"></span></p>
<p style="word-spacing:1px"><span
class="gmail-m_2525660176468897374gmaildefault"><i><span
style="color:blue">* Structured to meet
the diverse needs of the OSGeo community;</span></i></span><span
style="color:rgb(49,49,49)"></span></p>
<p style="word-spacing:1px"><i><span
style="color:rgb(49,49,49)">* </span><span
class="gmail-m_2525660176468897374gmaildefault"><span
style="color:blue">Designed to invite and
facilitate user contributions; and</span></span><span
style="color:rgb(49,49,49)"> </span></i><span
style="color:rgb(49,49,49)"></span></p>
<p style="word-spacing:1px"><span
class="gmail-m_2525660176468897374gmaildefault"><i><span
style="color:blue">* Linking to relevant
external learning resources</span></i></span></p>
<p> </p>
<p style="word-spacing:1px"><i><span
style="color:rgb(49,49,49)">* ... and what
else ??? </span></i><span
style="color:rgb(49,49,49)"></span></p>
</div>
<div>
<p class="MsoNormal"><u><span style="color:blue">Notes</span></u><span
style="color:blue"></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue">Replaced
"QGIS and GeoNetwork" with "OSGeo" as it is
succinct and enduring (evolving)</span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"> </span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue">Added
"community" (but kept "user" on the next line)
as it is broader and reflects core OSGeo
values (that we want to promote?)</span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"> </span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue">"Structured"
(could be designed?) meaning not just the
writing style, but also including
consideration of how different resource types
integrate (manuals, tutorials, etc.)</span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"> </span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue">"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></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"> </span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue">"Linking..."
to pick up my earlier comments about the
potential to consider how official
documentation can complement/integrate with
other resources.<span
class="gmail-m_2525660176468897374gmaildefault">
May be too ambitious, but worth considering
at this stage?</span></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"> </span></p>
</div>
<div>
<div>
<div>
<div>
<p class="MsoNormal"><span
style="color:blue">Cheers, Brian</span></p>
</div>
<div>
<p class="MsoNormal"> </p>
</div>
<div>
<p class="MsoNormal"><span
style="color:blue">0411-659-430</span></p>
</div>
<div>
<p class="MsoNormal"> </p>
</div>
<p class="MsoNormal"><a
href="http://linkedin.com/in/bpmcrae"
target="_blank" moz-do-not-send="true"><span
style="border:1pt solid
windowtext;padding:0in;text-decoration:none"><img
style="width: 1.0416in; height:
1.0416in;"
id="gmail-m_2525660176468897374Picture_x0020_1"
src="cid:part8.6CDAECFE.DFDF0C69@gmail.com" alt="Image removed by
sender." class="" width="100"
height="100" border="0"></span></a></p>
</div>
</div>
</div>
<p class="MsoNormal"> </p>
</div>
<p class="MsoNormal"> </p>
<div>
<div>
<p class="MsoNormal">On Sat, 1 Jun 2019 at 08:43,
Jared Morgan <<a
href="mailto:jaredleonmorgan@gmail.com"
target="_blank" moz-do-not-send="true">jaredleonmorgan@gmail.com</a>>
wrote:</p>
</div>
<blockquote
style="border-top:none;border-right:none;border-bottom:none;border-left:1pt
solid rgb(204,204,204);padding:0in 0in 0in
6pt;margin:5pt 0in 5pt 4.8pt">
<div>
<p class="MsoNormal">Yep I agree. Getting this
right is super important.</p>
</div>
<p class="MsoNormal"> </p>
<div>
<div>
<p class="MsoNormal">On Fri., 31 May 2019,
19:22 Jo Cook, <<a
href="mailto:jo.k.cook@gmail.com"
target="_blank" moz-do-not-send="true">jo.k.cook@gmail.com</a>>
wrote:</p>
</div>
<blockquote
style="border-top:none;border-right:none;border-bottom:none;border-left:1pt
solid rgb(204,204,204);padding:0in 0in 0in
6pt;margin:5pt 0in 5pt 4.8pt">
<div>
<p class="MsoNormal">As a further vision for
the overarching Google Season of Docs
project, I would like to add:</p>
<div>
<p class="MsoNormal"> </p>
</div>
<div>
<p class="MsoNormal">"Lowering the
barriers for users to contribute to
documentation"</p>
</div>
<div>
<p class="MsoNormal"> </p>
</div>
<div>
<p class="MsoNormal">Thanks</p>
</div>
<div>
<p class="MsoNormal"> </p>
</div>
<div>
<p class="MsoNormal">Jo</p>
</div>
</div>
<p class="MsoNormal"> </p>
<div>
<div>
<p class="MsoNormal">On Thu, May 30, 2019
at 9:39 PM Cameron Shorter <<a
href="mailto:cameron.shorter@gmail.com"
target="_blank" moz-do-not-send="true">cameron.shorter@gmail.com</a>>
wrote:</p>
</div>
<blockquote
style="border-top:none;border-right:none;border-bottom:none;border-left:1pt
solid rgb(204,204,204);padding:0in 0in 0in
6pt;margin:5pt 0in 5pt 4.8pt">
<div>
<p>Our email thread has covered multiple
topics, so I've changed the title and
am focusing here just on the question
of "Vision":</p>
<div>
<p class="MsoNormal">On 30/5/19 10:00
pm, Jared Morgan wrote:</p>
</div>
<blockquote
style="margin-top:5pt;margin-bottom:5pt">
<blockquote
style="border-top:none;border-right:none;border-bottom:none;border-left:1pt
solid rgb(204,204,204);padding:0in
0in 0in 6pt;margin:5pt 0in 5pt
4.8pt">
<p class="MsoNormal">> 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?</p>
</blockquote>
<div>
<p class="MsoNormal"> </p>
</div>
<div>
<p class="MsoNormal">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.</p>
</div>
<div>
<p class="MsoNormal"> </p>
</div>
<div>
<p class="MsoNormal">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.</p>
</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.</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.
</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></p>
<p><i>* ... and what else ??? </i></p>
<p>[1] <a
href="http://cameronshorter.blogspot.com/2018/11/comprehensive-research-into-open-source.html"
target="_blank"
moz-do-not-send="true">
http://cameronshorter.blogspot.com/2018/11/comprehensive-research-into-open-source.html</a>
</p>
<p>[2] <a
href="https://cameronshorter.blogspot.com/2018/12/catching-elusive-episodic-volunteer.html"
target="_blank"
moz-do-not-send="true">
https://cameronshorter.blogspot.com/2018/12/catching-elusive-episodic-volunteer.html</a></p>
<pre>-- </pre>
<pre>Cameron Shorter</pre>
<pre>Technology Demystifier</pre>
<pre>Open Technologies and Geospatial Consultant</pre>
<pre> </pre>
<pre>M +61 (0) 419 142 254</pre>
</div>
<p class="MsoNormal">_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a
href="mailto:SeasonOfDocs@lists.osgeo.org"
target="_blank" moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a><br>
<a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs"
target="_blank" moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a></p>
</blockquote>
</div>
<p class="MsoNormal"><br clear="all">
</p>
<div>
<p class="MsoNormal"> </p>
</div>
<p class="MsoNormal">-- </p>
<div>
<p class="MsoNormal">------------------------<br>
<a href="http://about.me/jocook"
target="_blank" moz-do-not-send="true">http://about.me/jocook</a></p>
</div>
<p class="MsoNormal">_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a
href="mailto:SeasonOfDocs@lists.osgeo.org"
target="_blank" moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a><br>
<a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs"
target="_blank" moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a></p>
</blockquote>
</div>
<p class="MsoNormal">_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org"
target="_blank" moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a><br>
<a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs"
target="_blank" moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a></p>
</blockquote>
</div>
</div>
</div>
</div>
</div>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank"
moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a><br>
<a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs"
rel="noreferrer" target="_blank" moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
SeasonOfDocs mailing list
<a class="moz-txt-link-abbreviated" href="mailto:SeasonOfDocs@lists.osgeo.org">SeasonOfDocs@lists.osgeo.org</a>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a>
</pre>
</blockquote>
<pre class="moz-signature" cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</body>
</html>