<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body>
<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">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>