<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<!--[if !mso]><style>v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style><![endif]--><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Consolas;
panose-1:2 11 6 9 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
pre
{mso-style-priority:99;
mso-style-link:"HTML Preformatted Char";
margin:0in;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:"Courier New";}
span.HTMLPreformattedChar
{mso-style-name:"HTML Preformatted Char";
mso-style-priority:99;
mso-style-link:"HTML Preformatted";
font-family:Consolas;}
p.msonormal0, li.msonormal0, div.msonormal0
{mso-style-name:msonormal;
mso-margin-top-alt:auto;
margin-right:0in;
mso-margin-bottom-alt:auto;
margin-left:0in;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
span.gmaildefault
{mso-style-name:gmail_default;}
span.EmailStyle21
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal">Hi All<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">My suggestions below are in green<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Regards<o:p></o:p></p>
<p class="MsoNormal"><br>
Chris<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormalCxSpMiddle" style="margin-left:1.7pt;mso-add-space:auto;text-autospace:none">
<b><i><span style="font-size:9.0pt;font-family:"Arial",sans-serif;color:black">Chris Pettit<o:p></o:p></span></i></b></p>
<p class="MsoNormalCxSpMiddle" style="margin-left:1.7pt;mso-add-space:auto;text-autospace:none">
<b><i><span style="font-size:9.0pt;font-family:"Arial",sans-serif;color:black">Professor of Urban Science<o:p></o:p></span></i></b></p>
<p class="MsoNormalCxSpMiddle" style="margin-left:1.7pt;mso-add-space:auto;text-autospace:none">
<i><span style="font-size:9.0pt;font-family:"Arial",sans-serif;color:black">Director, City Analytics
<o:p></o:p></span></i></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><b>From:</b> SeasonOfDocs <seasonofdocs-bounces@lists.osgeo.org>
<b>On Behalf Of </b>Brian McRae<br>
<b>Sent:</b> Saturday, June 1, 2019 12:54 PM<br>
<b>To:</b> seasonofdocs@lists.osgeo.org<br>
<b>Subject:</b> [SeasonOfDocs] Fwd: What is our vision?<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></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):<o:p></o:p></span></p>
</div>
<div>
<div>
<div>
<p class="MsoNormal"><span style="color:blue"><o:p> </o:p></span></p>
</div>
<div>
<p style="word-spacing:1px"><span style="color:#385723;mso-style-textfill-fill-color:#385723;mso-style-textfill-fill-alpha:100.0%">* quick and simple procedures for contributors to add content;<o:p></o:p></span></p>
<p><span class="gmaildefault"><i><span style="color:#385723;mso-style-textfill-fill-color:#385723;mso-style-textfill-fill-alpha:100.0%">* high level of visibility and recognition for contributors;</span><span style="color:#385723;mso-style-textfill-fill-color:#385723;mso-style-textfill-fill-alpha:100.0%"><o:p></o:p></span></i></span></p>
<p><i><span style="color:#313131">* Clear and intuitive documentation</span><span class="gmaildefault"><span style="color:blue">;</span></span></i><o:p></o:p></p>
<p style="word-spacing:1px"><i><span style="color:#313131">* </span><span class="gmaildefault"><span style="color:blue">C</span></span><span style="color:#313131">over</span><span class="gmaildefault"><span style="color:blue">ing</span></span><span style="color:#313131"> the </span><span class="gmaildefault"><span style="color:blue">evolving
</span></span><span style="color:#313131">breadth of </span><span class="gmaildefault"><span style="color:blue">OS</span></span><span style="color:#313131">Geo </span><span class="gmaildefault"><span style="color:blue">software;</span></span></i><span style="color:#313131"><o:p></o:p></span></p>
<p style="word-spacing:1px"><span class="gmaildefault"><i><span style="color:blue">* Structured to meet the diverse needs of the OSGeo community;</span></i></span><span style="color:#313131"><o:p></o:p></span></p>
<p style="word-spacing:1px"><i><span style="color:#313131">* </span><span class="gmaildefault"><span style="color:blue">Designed to invite and facilitate user contributions; and</span></span><span style="color:#313131"> </span></i><span style="color:#313131"><o:p></o:p></span></p>
<p style="word-spacing:1px"><span class="gmaildefault"><i><span style="color:blue">* Linking to relevant external learning resources</span><o:p></o:p></i></span></p>
<p><o:p> </o:p></p>
<p style="word-spacing:1px"><i><span style="color:#313131">* ... and what else ??? </span></i><span style="color:#313131"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><u><span style="color:blue">Notes</span></u><span style="color:blue"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue">Replaced "QGIS and GeoNetwork" with "OSGeo" as it is succinct and enduring (evolving)<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"><o:p> </o:p></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?)<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"><o:p> </o:p></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.)<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"><o:p> </o:p></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><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"><o:p> </o:p></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="gmaildefault"> May be too ambitious, but worth considering
at this stage?</span><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue"><o:p> </o:p></span></p>
</div>
<div>
<div>
<div>
<div>
<p class="MsoNormal"><span style="color:blue">Cheers, Brian</span><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal"><span style="color:blue">0411-659-430</span><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal"><a href="http://linkedin.com/in/bpmcrae" target="_blank"><span style="border:solid windowtext 1.0pt;padding:0in;text-decoration:none"><img border="0" width="100" height="100" style="width:1.0416in;height:1.0416in" id="Picture_x0020_1" src="cid:~WRD019.jpg" alt="Image removed by sender."></span></a><o:p></o:p></p>
</div>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div>
<p class="MsoNormal">On Sat, 1 Jun 2019 at 08:43, Jared Morgan <<a href="mailto:jaredleonmorgan@gmail.com" target="_blank">jaredleonmorgan@gmail.com</a>> wrote:<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<div>
<p class="MsoNormal">Yep I agree. Getting this right is super important.<o:p></o:p></p>
</div>
<p class="MsoNormal"><o:p> </o:p></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">jo.k.cook@gmail.com</a>> wrote:<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<div>
<p class="MsoNormal">As a further vision for the overarching Google Season of Docs project, I would like to add:<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">"Lowering the barriers for users to contribute to documentation"<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Thanks<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Jo<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></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">cameron.shorter@gmail.com</a>> wrote:<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<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":<o:p></o:p></p>
<div>
<p class="MsoNormal">On 30/5/19 10:00 pm, Jared Morgan wrote:<o:p></o:p></p>
</div>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<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?<o:p></o:p></p>
</blockquote>
<div>
<p class="MsoNormal"><o:p> </o:p></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.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></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.<o:p></o:p></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>.<o:p></o:p></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.<o:p></o:p></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.
<o:p></o:p></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><o:p></o:p></p>
<p>What is our vision for QGIS and GeoNetwork documentation and this Season of Docs initiative? Maybe:<o:p></o:p></p>
<p><i>* Clear and intuitive documentation</i><o:p></o:p></p>
<p><i>* Which addresses our key user groups (defined as ???)</i><o:p></o:p></p>
<p><i>* Which covers the breadth of rapidly innovating QGIS and GeoNetwork software
</i><o:p></o:p></p>
<p><i>* ... and what else ??? </i><o:p></o:p></p>
<p>[1] <a href="http://cameronshorter.blogspot.com/2018/11/comprehensive-research-into-open-source.html" target="_blank">
http://cameronshorter.blogspot.com/2018/11/comprehensive-research-into-open-source.html</a>
<o:p></o:p></p>
<p>[2] <a href="https://cameronshorter.blogspot.com/2018/12/catching-elusive-episodic-volunteer.html" target="_blank">
https://cameronshorter.blogspot.com/2018/12/catching-elusive-episodic-volunteer.html</a><o:p></o:p></p>
<pre>-- <o:p></o:p></pre>
<pre>Cameron Shorter<o:p></o:p></pre>
<pre>Technology Demystifier<o:p></o:p></pre>
<pre>Open Technologies and Geospatial Consultant<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>M +61 (0) 419 142 254<o:p></o:p></pre>
</div>
<p class="MsoNormal">_______________________________________________<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" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><o:p></o:p></p>
</blockquote>
</div>
<p class="MsoNormal"><br clear="all">
<o:p></o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<p class="MsoNormal">-- <o:p></o:p></p>
<div>
<p class="MsoNormal">------------------------<br>
<a href="http://about.me/jocook" target="_blank">http://about.me/jocook</a><o:p></o:p></p>
</div>
<p class="MsoNormal">_______________________________________________<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" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><o:p></o:p></p>
</blockquote>
</div>
<p class="MsoNormal">_______________________________________________<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" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><o:p></o:p></p>
</blockquote>
</div>
</div>
</div>
</div>
</body>
</html>