<div dir="ltr"><div>Happy for a call at either time, whichever works best for people.</div><div><br></div><div>Jo<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Dec 16, 2019 at 7:04 PM Cameron Shorter <<a href="mailto:cameron.shorter@gmail.com">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">
<div bgcolor="#FFFFFF">
<p>Ah, I notice there is a scheduled meeting half a day earlier
(Thursday evening for you Byron).</p>
<p>Byron, would you have finished your deadline by then? Could you
make the scheduled meeting? </p>
<p>I assume that would be preferable.<br>
</p>
<div>On 17/12/19 5:57 am, Cameron Shorter
wrote:<br>
</div>
<blockquote type="cite">
<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" target="_blank">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 style="box-sizing:border-box;border-collapse:collapse;border-spacing:0px;background:rgb(255,255,255) none repeat scroll 0% 0%;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;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;text-decoration-style:initial;text-decoration-color:initial">
<thead style="box-sizing:border-box;text-align:left"><tr style="box-sizing:border-box">
<th style="box-sizing:border-box;padding:5px 9px;text-align:left">Location</th>
<th style="box-sizing:border-box;padding:5px 9px;text-align:left;border-left:1px solid rgb(204,204,204)">Local Time</th>
<th style="box-sizing:border-box;padding:5px 9px;text-align:left;border-left:1px solid rgb(204,204,204)">Time Zone</th>
<th style="box-sizing:border-box;padding:5px 9px;text-align:left;border-left:1px solid rgb(204,204,204)">UTC Offset</th>
</tr>
</thead><tbody style="box-sizing:border-box">
<tr style="box-sizing:border-box;background:rgb(255,255,255) none repeat scroll 0% 0%">
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none"><a href="https://www.timeanddate.com/worldclock/australia/melbourne" title="Current local time in Melbourne" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">Melbourne</a><span> </span><span 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:medium none">Friday, 20 December
2019 at 6:00:00 am</td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none"><a href="https://www.timeanddate.com/time/zones/aedt" title="Australian Eastern Daylight Time" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">AEDT</a></td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none">UTC+11 hours</td>
</tr>
<tr style="box-sizing:border-box;background:rgb(243,243,243) none repeat scroll 0% 0%;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:medium none"><a href="https://www.timeanddate.com/worldclock/new-zealand/wellington" title="Current local time in Wellington" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">Wellington</a><span> </span><span 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:medium none">Friday, 20 December
2019 at 8:00:00 am</td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none"><a href="https://www.timeanddate.com/time/zones/nzdt" title="New Zealand Daylight Time" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">NZDT</a></td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none">UTC+13 hours</td>
</tr>
<tr style="box-sizing:border-box;background:rgb(255,255,255) none repeat scroll 0% 0%">
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none"><a href="https://www.timeanddate.com/worldclock/uk/london" title="Current local time in London" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">London</a><span> </span><span 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:medium none">Thursday, 19 December
2019 at 7:00:00 pm</td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none"><a href="https://www.timeanddate.com/time/zones/gmt" title="Greenwich Mean Time" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">GMT</a></td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none">UTC</td>
</tr>
<tr style="box-sizing:border-box;background:rgb(243,243,243) none repeat scroll 0% 0%;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:medium none"><a href="https://www.timeanddate.com/worldclock/netherlands/amsterdam" title="Current local time in Amsterdam" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">Amsterdam</a><span> </span><span 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:medium none">Thursday, 19 December
2019 at 8:00:00 pm</td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none"><a href="https://www.timeanddate.com/time/zones/cet" title="Central European Time" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">CET</a></td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none">UTC+1 hour</td>
</tr>
<tr style="box-sizing:border-box;background:rgb(255,255,255) none repeat scroll 0% 0%">
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none">Corresponding UTC
(GMT)</td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none"><a href="https://www.timeanddate.com/worldclock/fixedtime.html?iso=20191219T1900" style="box-sizing:border-box;background:transparent none repeat scroll 0% 0%;color:rgb(85,107,181);text-decoration:none" target="_blank">Thursday, 19 December 2019 at
19:00:00</a></td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium none"> </td>
<td style="box-sizing:border-box;padding:0.4em;vertical-align:top;border:medium 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>On 16/12/19 10:22 pm, Swapnil Ogale
wrote:<br>
</div>
<blockquote type="cite">
<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" target="_blank">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">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_-1531534521345710544gmail-m_-2302608862495278445gmail-m_91153481329543595082316BABB-D473-448E-8CE8-573A58B8E9FD" src="cid:16f13adcc056dda8c9a1"></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">byron@openwork.nz</a><br>
+64 21 794 501<br>
<a href="https://www.openwork.nz/" target="_blank">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">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">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">http://about.me/jocook</a></div>
</blockquote>
</div>
</blockquote>
<pre cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</blockquote>
<pre cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</div>
</blockquote></div><br clear="all"><br>-- <br><div dir="ltr" class="gmail_signature">------------------------<br><a href="http://about.me/jocook" target="_blank">http://about.me/jocook</a></div>