<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">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">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">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">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">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">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">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">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>