<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>Thanks for all the background and suggestions Jo. And thanks
Byron for responding while on a work deadline (which definitely
takes priority).</p>
<p>I'm hopeful that we can give Swapnil some direction and a chance
to ask questions before we all go offline for a couple of weeks
over Xmas. It looks like the might be a possible spot at the end
of this week. (Friday morning in Australia/New Zealand, Thursday
evening in Europe). I suggest we set a quick 20 minute "virtual
standup" meeting.</p>
<p>I can do 6am (with video) or 8am (probably only with IRC)
Melbourne/Sydney time. Ie, the follow timeslot, or 2 hours later:</p>
<p><a
href="https://www.timeanddate.com/worldclock/meetingdetails.html?year=2019&month=12&day=19&hour=19&min=0&sec=0&p1=152&p2=264&p3=136&p4=16">https://www.timeanddate.com/worldclock/meetingdetails.html?year=2019&month=12&day=19&hour=19&min=0&sec=0&p1=152&p2=264&p3=136&p4=16</a></p>
<table class="xpad border2" style="box-sizing: border-box;
border-collapse: collapse; border-spacing: 0px; background:
rgb(255, 255, 255); text-align: left; border: 1px solid rgb(221,
221, 221); color: rgb(69, 69, 69); font-family: Helvetica, Arial,
sans-serif; font-size: 14px; font-style: normal;
font-variant-ligatures: normal; font-variant-caps: normal;
font-weight: 400; letter-spacing: normal; orphans: 2; text-indent:
0px; text-transform: none; white-space: normal; widows: 2;
word-spacing: 0px; -webkit-text-stroke-width: 0px;
text-decoration-style: initial; text-decoration-color: initial;">
<thead style="box-sizing: border-box; text-align: left;"><tr
class="head" style="box-sizing: border-box;">
<th style="box-sizing: border-box; padding: 5px 9px;
text-align: left;">Location</th>
<th class="sep" style="box-sizing: border-box; padding: 5px
9px; text-align: left; border-left: 1px solid rgb(204, 204,
204) !important;">Local Time</th>
<th class="sep" style="box-sizing: border-box; padding: 5px
9px; text-align: left; border-left: 1px solid rgb(204, 204,
204) !important;">Time Zone</th>
<th class="sep" style="box-sizing: border-box; padding: 5px
9px; text-align: left; border-left: 1px solid rgb(204, 204,
204) !important;">UTC Offset</th>
</tr>
</thead><tbody style="box-sizing: border-box;">
<tr class="c0" style="box-sizing: border-box; background:
rgb(255, 255, 255);">
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/worldclock/australia/melbourne"
title="Current local time in Melbourne" style="box-sizing:
border-box; background: transparent; color: rgb(85, 107,
181); text-decoration: none;">Melbourne</a><span> </span><span
class="small" style="box-sizing: border-box; font-size:
12.6px;">(Australia - Victoria)</span></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">Friday, 20 December 2019
at 6:00:00 am</td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/time/zones/aedt"
title="Australian Eastern Daylight Time"
style="box-sizing: border-box; background: transparent;
color: rgb(85, 107, 181); text-decoration: none;">AEDT</a></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">UTC+11 hours</td>
</tr>
<tr class="c1" style="box-sizing: border-box; background:
rgb(243, 243, 243); border-top: 1px solid rgb(221, 221, 221);
border-bottom: 1px solid rgb(221, 221, 221);">
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/worldclock/new-zealand/wellington"
title="Current local time in Wellington"
style="box-sizing: border-box; background: transparent;
color: rgb(85, 107, 181); text-decoration: none;">Wellington</a><span> </span><span
class="small" style="box-sizing: border-box; font-size:
12.6px;">(New Zealand - Wellington)</span></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">Friday, 20 December 2019
at 8:00:00 am</td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/time/zones/nzdt"
title="New Zealand Daylight Time" style="box-sizing:
border-box; background: transparent; color: rgb(85, 107,
181); text-decoration: none;">NZDT</a></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">UTC+13 hours</td>
</tr>
<tr class="c0" style="box-sizing: border-box; background:
rgb(255, 255, 255);">
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/worldclock/uk/london"
title="Current local time in London" style="box-sizing:
border-box; background: transparent; color: rgb(85, 107,
181); text-decoration: none;">London</a><span> </span><span
class="small" style="box-sizing: border-box; font-size:
12.6px;">(United Kingdom - England)</span></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">Thursday, 19 December
2019 at 7:00:00 pm</td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/time/zones/gmt"
title="Greenwich Mean Time" style="box-sizing: border-box;
background: transparent; color: rgb(85, 107, 181);
text-decoration: none;">GMT</a></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">UTC</td>
</tr>
<tr class="c1" style="box-sizing: border-box; background:
rgb(243, 243, 243); border-top: 1px solid rgb(221, 221, 221);
border-bottom: 1px solid rgb(221, 221, 221);">
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/worldclock/netherlands/amsterdam"
title="Current local time in Amsterdam" style="box-sizing:
border-box; background: transparent; color: rgb(85, 107,
181); text-decoration: none;">Amsterdam</a><span> </span><span
class="small" style="box-sizing: border-box; font-size:
12.6px;">(Netherlands)</span></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">Thursday, 19 December
2019 at 8:00:00 pm</td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/time/zones/cet"
title="Central European Time" style="box-sizing:
border-box; background: transparent; color: rgb(85, 107,
181); text-decoration: none;">CET</a></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">UTC+1 hour</td>
</tr>
<tr class="c0" style="box-sizing: border-box; background:
rgb(255, 255, 255);">
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;">Corresponding UTC (GMT)</td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"><a
href="https://www.timeanddate.com/worldclock/fixedtime.html?iso=20191219T1900"
style="box-sizing: border-box; background: transparent;
color: rgb(85, 107, 181); text-decoration: none;">Thursday,
19 December 2019 at 19:00:00</a></td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"> </td>
<td style="box-sizing: border-box; padding: 0.4em;
vertical-align: top; border: none;"> </td>
</tr>
</tbody>
</table>
<p>Can anyone else make this? I'm happy to do this with just me and
Swapnil if others are not available. <br>
</p>
<p>I'll send a meeting invite to hangouts to those in the CC list
for the earlier timeslot. If you would like an invitation, email
me.</p>
<p>Cheers, Cameron<br>
</p>
<div class="moz-cite-prefix">On 16/12/19 10:22 pm, Swapnil Ogale
wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAD4SXx8_vK_+oeXMg2qnVi6GEReEMyX_duasgqLVdFGgjNv5Ag@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 Jo,</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Thanks for your email.
I agree with the installation on the Windows bit, as I feel
that will sort out a few issues itself. I am happy to look at
the documentation for Linux and Windows (assuming this
exists?) and see how we can make this clear for our users. </div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">From there, I think
Byron's spreadsheet can form a good base on how to tackle the
documentation for GeoNetwork. I am happy to look at missing
docs to get an idea of working on the product itself, but also
assist with setting up some templates.</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif">Happy to chat more this
week and discuss.</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 class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
<div class="gmail_default"
style="font-family:verdana,sans-serif"><br>
</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Mon, 16 Dec 2019 at 22:04,
Jo Cook <<a href="mailto:jo.k.cook@gmail.com"
moz-do-not-send="true">jo.k.cook@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>Hi All,</div>
<div><br>
</div>
<div>I should definitely have given an update on the
GeoNetwork documentation code sprint before this- I do
apologise, but I've been snowed under with work and
conferences.<br>
</div>
<div><br>
</div>
<div>Firstly working through this thread- as Cameron said
initially- the documentation task for Geonetwork is huge-
there's no doubt about that, but there was never any
intention it should be entirely the work of one person to
fix that problem. Again, I'd like to reiterate that if
there's a problem installing on Windows then that's a
great place to start fixing things and I'm happy to help
with that.</div>
<div><br>
</div>
<div>Secondly I'm in two minds about whether auditing the
existing docs in the way that Felicity did is the best
place to start, as to an extent that has already been done
in Byron's spreadsheet, which has been adopted as the de
facto guide to completeness. Personally I think the
current priority is not that a document gets 5/5 for best
practices, but that it's present and complete in terms of
functionality, and that users are not put off by mistakes
or missing steps. New documentation could, however, be
built from templates, but I think that's a decision for
the wider Geonetwork PSC. Happy to be argued down about
this though, particularly if Swapnil feels his talents
would be better used in a different way. <br>
</div>
<div><br>
</div>
<div>Now to the code sprint. Basically we took Byron's
spreadsheet and various people assigned themselves
sections to work on. When sections were completed they
were marked as such. The focus was on larger sections that
needed updating or adding altogether. We also improved the
"how to contribute to the documentation" section as it was
missing steps, so it should be much easier for people to
contribute in future. I also went through all of the
release notes from 3.6 onwards, ensuring that there were
GitHub issues for anything missing, out of date, or
incomplete as a result of new user-facing functionality (I
ignored anything that could not be seen in the user
interface). Continuing this process for subsequent
releases should now be fairly straightforward and it's a
task I'm happy to undertake, and the GitHub issues are
small enough and hopefully simple enough that any user
could help with fixing them. There's now also an
unofficial process whereby for large documentation
updates, pull requests are reviewed before they can be
accepted.</div>
<div><br>
</div>
<div>I think that as we're coming up to Christmas and a lot
of us are likely to take significant amounts of time off,
let's take a break now from the fortnightly meetings and
re-group and re-launch in January. We can hopefully get
Francois to join us as well by then. Having said that, I
should have time this week to attempt to install
Geonetwork on windows 10, if that would help Swapnil?</div>
<div><br>
</div>
<div>Thoughts?</div>
<div><br>
</div>
<div>Jo<br>
</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Sun, Dec 15, 2019 at
9:45 PM Byron Cochrane <<a
href="mailto:byron@openwork.nz" target="_blank"
moz-do-not-send="true">byron@openwork.nz</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>Hi All,
<div><br>
</div>
<div>Sorry about the slow response. Been a bit
overloaded with things to get done by the end of
Thursday this week.</div>
<div>Friday would be about the only availability I have
this week for a meeting. Jo at least should be in this
call. Paul and others more involved would also be
useful. My bandwidth for unpaid work is a bit maxed
out right now but will contribute what I can.</div>
<div><br>
</div>
<div>Francois Prunayre (a core GN developer) organised a
documentation codesprint a few weeks ago and made some
good progress against my spreadsheet. Several people
from our group participated including Jo Cook, Maria
Arias de Reyna, and Paul van Genuchten. I was not able
to participate to any significant degree myself. Jo
should be able to give good feedback on how that
progressed. I would think that this document
codesprint, its progress and results should be a good
point for relaunching our efforts here. I would think
it useful to contact Francois to get his perspective
on a way forward.</div>
<div><br>
</div>
<div>I have also been looking for an excuse to contact
Simon Pigot (another GN core developer - Aus based).
He seems to be getting somewhat active again. I could
contact him to get his thoughts?</div>
<div><br>
</div>
<div>Cheers,</div>
<div>
<div>
<div
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0)">Byron
Cochrane<br>
</div>
<span
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0)"></span><br
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0)">
<span
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0)"></span><span
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0)"></span><span
style="color:rgb(0,0,0);font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none"></span><span><img
id="gmail-m_-2302608862495278445gmail-m_91153481329543595082316BABB-D473-448E-8CE8-573A58B8E9FD"
src="cid:part13.9CF5A082.63D1F7C7@gmail.com"
class=""></span>
<div
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0)"><br>
<br>
<br>
<br>
OpenWork Ltd<br>
Nelson, New Zealand<br>
<a href="mailto:byron@openwork.nz" target="_blank"
moz-do-not-send="true">byron@openwork.nz</a><br>
+64 21 794 501<br>
<a href="https://www.openwork.nz/" target="_blank"
moz-do-not-send="true">https://www.openwork.nz/</a></div>
<br
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0)">
<span
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0);float:none;display:inline">“</span><span
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0);float:none;display:inline"><i>The
whole problem with the world is that fools and
fanatics are so certain of themselves, yet wiser
people so full of doubt</i></span><span
style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration:none;color:rgb(0,0,0);float:none;display:inline">”
- Bertrand Russell</span>
</div>
<div><br>
<blockquote type="cite">
<div>On 12/12/2019, at 11:29 PM, Cameron Shorter
<<a href="mailto:cameron.shorter@gmail.com"
target="_blank" moz-do-not-send="true">cameron.shorter@gmail.com</a>>
wrote:</div>
<br>
<div>
<div>I had a chat with Swapnil today. I'm
mindful that the doc task for GeoNetwork is
huge, and that there is more than one person
is going to be able to do in 3 months. So lets
be strategic in how we make use of Swapnil's
time.<br>
<br>
My suggestions:<br>
<br>
* Swapnil has had problems getting GeoNetwork
installed on Windows 10. I've suggested
installing on Ubuntu or Lubuntu, probably in
VirtualBox, maybe also look at OSGeoLive
installed into VirtualBox. (Some GeoNetwork
folks might be able to give better advise.<br>
<br>
* I think that Swapnil should start to build
up a best practices recommended architecture
for an Open Source docset (based on <a
href="https://www.divio.com/blog/documentation/"
target="_blank" moz-do-not-send="true">https://www.divio.com/blog/documentation/</a>
)<br>
<br>
* He should then audit existing docs against
best practices to create a gap analysis. (For
OSGeoLive work, Felicity gave a 5 start rating
to all 50 Quickstarts she worked on. Maybe do
something similar).<br>
<br>
* This should lead to a very large potential
body of documentation work to be done, from
which Swapnil should focus on specific parts.<br>
<br>
* Focus should be on helping amplify the
writing effectiveness of existing volunteer
writers.<br>
<br>
* This might involve providing writing
templates (which are starting to emerge in
TheGoodDocsProject)<br>
<br>
* We should also provide a checklist about
what docs should have before they are
considered "done". The GeoNetwork Project
Steering Committee probably should consider
that a feature is not considered complete
until it has docs which meet the minimal
requirements of this checklist.<br>
<br>
* I know Byron (and others?) have started a
doc audit and built a spreadsheet.<br>
<br>
* Would it be possible to get Byron, Swapnil,
me (and others?) onto a call within the next
week? Byron, what is your availability like?
Maybe a weekday evening, or most times during
this weekend should work for me. (Byron is in
New Zealand, Swapnil and I are both in the
same timezone in Melbourne/Sydney). Anyone
else want to be included in this call?<br>
<br>
-- <br>
Cameron Shorter<br>
Technology Demystifier<br>
Open Technologies and Geospatial Consultant<br>
<br>
M +61 (0) 419 142 254<br>
<br>
</div>
</div>
</blockquote>
</div>
<br>
</div>
</div>
</blockquote>
</div>
<br clear="all">
<br>
-- <br>
<div dir="ltr">------------------------<br>
<a href="http://about.me/jocook" target="_blank"
moz-do-not-send="true">http://about.me/jocook</a></div>
</blockquote>
</div>
</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>