<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<p>PS, we have just over a month left with SeasonOfDocs to get some
runs on the board. Let's discuss how we can best make use of this
remaining time at the meeting. Final week (when we wrap up tasks)
starts on Monday 24 Feb.<br>
</p>
<div class="moz-cite-prefix">On 30/1/20 6:46 am, Cameron Shorter
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:6a918386-f889-276a-1fd5-53d103d0bc44@gmail.com">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<p>Yes, this tutorial is good.</p>
<p>It deviates slightly from TheGoodDocsProject which is not
perfect. In some places I prefer your approach, in others I
prefer TheGoodDocsProject. Resolving the differences is a bigger
problem and we don't have a long term timeframe for your
GeoNetwork involvement.</p>
<p>I'll have some minor feedback, but as a first pass, I think
this is good to go.</p>
<p>I think that it will be good to have both you and others use
this template for specific tutorials and assess how it goes.</p>
<p>Yes, let's discuss at meeting today.</p>
<p>Cheers, Cameron<br>
</p>
<div class="moz-cite-prefix">On 29/1/20 11:49 pm, Swapnil Ogale
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAD4SXx-gSx8RY5FCjpEogKHg+Sn17xDHTQVY5PqwvKHjnt-9mw@mail.gmail.com">
<meta http-equiv="content-type" content="text/html;
charset=UTF-8">
<div dir="ltr">
<div class="gmail_default"
style="font-family:verdana,sans-serif">Hi all,</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">I've added a new
template for Tutorials: <a
href="https://docs.google.com/document/d/1hMG2pcc-Dl0I_9ut7FUvNQxAu6Oe_qjh0QC61pv7lvI/edit?usp=sharing"
moz-do-not-send="true">https://docs.google.com/document/d/1hMG2pcc-Dl0I_9ut7FUvNQxAu6Oe_qjh0QC61pv7lvI/edit?usp=sharing</a></div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Can you please review
this and we can discuss this tomorrow?</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Thanks,</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Swapnil</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Mon, 20 Jan 2020 at
23:33, Swapnil Ogale <<a
href="mailto:swapnilogale@gmail.com"
moz-do-not-send="true">swapnilogale@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">
<div dir="ltr">
<div class="gmail_default"
style="font-family:verdana,sans-serif">Thanks for the
notes Cameron.</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">As discussed,
I've had a go at putting together some info for a
How-To article: <a
href="https://docs.google.com/document/d/1lSoAf9vDeuSvsF6snCDKsIvFpiSJV8_ouXs_ovrXWWA/edit?usp=sharing"
target="_blank" moz-do-not-send="true">https://docs.google.com/document/d/1lSoAf9vDeuSvsF6snCDKsIvFpiSJV8_ouXs_ovrXWWA/edit?usp=sharing</a></div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">(I've also
added an example using the template in the same doc)</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Can you please
review this and let me know what you think?</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Meanwhile, I'll
keep working on updating Byron's spreadsheet on
identifying the gaps.</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Cheers,</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Swapnil</div>
</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Thu, 16 Jan 2020 at
21:12, Cameron Shorter <<a
href="mailto:cameron.shorter@gmail.com"
target="_blank" moz-do-not-send="true">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">Present: Swapnil
Ogale, Jo Cook, Paul van Genuchten, Byron Cochrain, <br>
Maria Aras de Rayna<br>
<br>
Swapnil has reviewed Windows getting started
documentation, and has <br>
worked out how to get it working. He will be submitting
changes.<br>
<br>
In list of documents [1] Swapnil has categorised
"Current Content Type" <br>
pages as per key doc types[2]. Next, Swapnil plans to
categorise pages <br>
into "Ideal Document Types" and enable finding gaps.<br>
<br>
Maria noted that to date, most documentation has been
developed by <br>
individuals without much collaboration. She thinks it
valuable to <br>
provide a template which people can write against and
collaborate around.<br>
<br>
Paul/Maria noted that there is an extensive translations
of GeoNetwork <br>
docs. We considered limiting doc changes due to impact
on translations. <br>
However, with Maria's blessing, we feel that it is best
to have at least <br>
one excellent set of English docs, and it is then up to
the translators <br>
to keep up.<br>
<br>
Jo suggested that we should suggest that translators
wait for a set <br>
milestone and doc baseline before translating. Eg: wait
until Swapnil <br>
finishes SeasonOfDocs stint. (Final week is 24 Feb
2020).<br>
<br>
If Paul is right about there being a healthy community
of translators, <br>
some of these people might be able to help improve
existing docs if we <br>
provide a suitable template to follow. Paul said he'd
follow up on this.<br>
<br>
Swapnil volunteered to convert an existing doc to an
exemplar doc, using <br>
TheGoodDocsProject [3] [4] as a guide (note that it is
still alpha and <br>
might not fit well with GeoNework). Swapnil will focus
on a Howto first, <br>
then move to a Tutorial.<br>
<br>
Once an exemplar is in place, Swapnil will invite others
to review. I'll <br>
review, hope others will too.<br>
<br>
After the review, Paul and Maria offered to test writing
against the <br>
exemplar / template. Byron is interested in writing
Tutorials, which <br>
could be against the template too.<br>
<br>
Jo will update the calendar invite - next meeting in 2
weeks. It appears <br>
some people's calendars need refreshing.<br>
<br>
[1] List of geonetwork doc pages and their status <br>
<a
href="https://docs.google.com/spreadsheets/d/1l5FwIj5wpr7QUGsmVNJsvvK5KenMEhHmdL_svfeqDXk/edit#gid=1668835383"
rel="noreferrer" target="_blank"
moz-do-not-send="true">https://docs.google.com/spreadsheets/d/1l5FwIj5wpr7QUGsmVNJsvvK5KenMEhHmdL_svfeqDXk/edit#gid=1668835383</a><br>
<br>
[2] The four key doc types <a
href="https://www.divio.com/blog/documentation/"
rel="noreferrer" target="_blank"
moz-do-not-send="true">https://www.divio.com/blog/documentation/</a><br>
<br>
[3] The Good Docs Project Templates 0.1 in Google Docs:
<br>
<a
href="https://drive.google.com/drive/folders/1Z-UORVQp9TXxU94SphfMh1UkmE7yEom8"
rel="noreferrer" target="_blank"
moz-do-not-send="true">https://drive.google.com/drive/folders/1Z-UORVQp9TXxU94SphfMh1UkmE7yEom8</a><br>
<br>
[4] The Good Docs Project Templates more recent source
(view raw source <br>
to see comments): <br>
<a
href="https://github.com/thegooddocsproject/templates/tree/master/how-to"
rel="noreferrer" target="_blank"
moz-do-not-send="true">https://github.com/thegooddocsproject/templates/tree/master/how-to</a><br>
<br>
<br>
-- <br>
Cameron Shorter<br>
Technology Demystifier<br>
Open Technologies and Geospatial Consultant<br>
<br>
M +61 (0) 419 142 254<br>
<br>
</blockquote>
</div>
</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" moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" moz-do-not-send="true">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>
</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>