<div dir="ltr"><div>Hi Byron,</div><div><br></div><div>First things first- it's not currently all that easy to find the issues for the docs- which is something we should probably address. They are here: <a href="https://github.com/geonetwork/doc/issues">https://github.com/geonetwork/doc/issues</a></div><div><br></div><div>Disclaimer- at present I'm probably the one person labelling up the issues- but my feeling is that those areas that you feel need improvement within the documentation (workflow, administration, additional schema plugins, harvesting, plugins and schema implementation) could all be flagged up as well- as something like "needs improvement". I'd be happy to see you submit a bunch of issues in for things like that, and then I will label them up. Is that something you could do without needing to spend too much time on it, given your work commitments?<br></div><div><br></div><div>I don't know if this sounds like a plan as well, but with the schema documentation (ISO19115-3 guidance)- would <a href="http://metadata101.org">metadata101.org</a> be a good place for that to live?</div><div><br></div><div>My first job, I think, is going to be to figure out who looks after the Readthedocs side of things so we can fix the "edit on github" links!</div><div><br></div><div>Hope that makes sense,</div><div><br></div><div>Jo<br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Wed, Jun 5, 2019 at 11:38 PM Byron Cochrane <<a href="mailto:byron@openwork.nz">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 style="overflow-wrap: break-word;">Hi Jo,<div><br><div>All aboard with everything have suggested.</div><div>But where do I find the “easy to resolve” issues you mention on the GitHub site? I am not seeing those.</div><div><br></div><div>A bit about my current focus. Besides being a general GeoNetwork enthusiast and one of the most prolific implementers of this software in the Oceana region, I currently have a couple of projects underway that relate well to this work. The first is development of good practice guidance for using ISO19115-3 in Australia and NZ. GeoNetwork, being one of the very few existing catalogues that support this standard is our reference platform. I would think a version of this document specific to GN users could be useful.</div><div><br></div><div>I am also aiding NIWA here in NZ in improving their cataloguing capabilities. This is based on GeoNetwork, but needs to tie in with other catalogues as well. So issues around workflow, administration, additional schema plugins, harvesting, etc. are all needed to be well documented. Forefront here is good documentation on plugin schema support and implementation. These plugins have become pretty central to customisation and have fallen badly behind in documentation, so that is where I would like to put some initial focus.</div><div><br></div><div>In general I found documentation to be the Achilles heel for may open source projects. Identifying what works to get good documentation is of immense value to making a successful product. At least in this part of the world, GN has a mixed reputation. The negative perceptions are largely around the view that it is too complex. Good documentation could help. I think of GeoNetwork as a software stack of which some parts are useful to some installs and some parts will not be. Documentation that describes this stack in a way that organisations can understand how to make best use of the different components of this stack would be extremely useful.</div><div><br></div><div>Unless I can tie some of this directly to paid work, putting in more than 4-6 hours a week to this effort will be a struggle, but I will do what I can. I may be able to leverage some time from my business partner as well.</div><div><br></div><div>So how do we proceed?</div><div><br></div><div>Cheers,<br><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><img id="gmail-m_-4341299100204511278249BC1B1-ACA7-467A-A39F-5D7F815E6C84" src="cid:16b3103c5bf6dda8c9a1"></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 class="gmail-m_-4341299100204511278Apple-interchange-newline">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="http://openwork.nz" target="_blank">http://openwork.nz</a> <br></div><br class="gmail-m_-4341299100204511278Apple-interchange-newline" 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 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">
</div>
<div><br><blockquote type="cite"><div>On 5/06/2019, at 9:00 PM, Jo Cook <<a href="mailto:jo.k.cook@gmail.com" target="_blank">jo.k.cook@gmail.com</a>> wrote:</div><br class="gmail-m_-4341299100204511278Apple-interchange-newline"><div><div dir="ltr"><div>Hi Bryan,</div><div><br></div><div>Great to have another Geonetwork person on board! Have you seen our (myself and Maria's) ideas for what to do for Geonetwork at <a href="https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#GeoNetwork" target="_blank">https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#GeoNetwork</a>? Feel free to add/adjust as you see fit. I did send a message asking for suggestions/contributions on the geonetwork mailing list but got no response unfortunately. <br></div><div><br></div><div>All the best</div><div><br></div><div>Jo<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Jun 4, 2019 at 11:40 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>Hello,<div><br></div><div>My name is Byron Cochrane. I am a long time GeoNetwork implementor and developer and very interested in improving GeoNetwork documentation. Currently have my own independent consultancy in New Zealand in which GeoNetwork and Metadata . Contributing to metadata guidance comprise the majority of our work at present. </div><div><br></div><div>I have a long history of involvement in standardisation and cataloguing going back to 1994. This includes deep involvement in regional and international standards organisations including ANZLIC, ICSM, ISO TC 211, OGC and W3C. I have contributed to numerous international standards documents, testbeds and interoperability experiments including W3C Spatial Data on the Web Best Practices, Environmental Linked Features Interoperability Experiment (OGC), and numerous others. </div><div><br></div><div>I have been an implementer and developer of GeoNetwork in Oceana and supporter of open source many years. Current relevant projects include the development of guidance for the implementation of ISO 19115-3 in the Oceana region and consolidated immigration and implementation of GeoNetwork 3.6 for a large national agency. I am very interested in helping improve GeoNetwork documentation. Much of our current work requires this and the more integrated and sharable with other efforts the better.</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">Byron Cochrane<br></div><span><span id="gmail-m_-4341299100204511278cid:16b26dc01aa6dda8c9a1"><openwork_favicon__white96x96.png></span></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"><br class="gmail-m_-4341299100204511278gmail-m_7298344743282618288Apple-interchange-newline">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="http://openwork.nz/" target="_blank">http://openwork.nz</a> <br></div><br class="gmail-m_-4341299100204511278gmail-m_7298344743282618288Apple-interchange-newline" 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"><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">
</div>
<br></div></div>_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank">SeasonOfDocs@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote></div><br clear="all"><br>-- <br><div dir="ltr" class="gmail-m_-4341299100204511278gmail_signature">------------------------<br><a href="http://about.me/jocook" target="_blank">http://about.me/jocook</a></div>
</div></blockquote></div><br></div></div></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></div>