<div dir="ltr"><div class="gmail_default" style="font-family:verdana,sans-serif">GeoNetwork - Season of Docs proposal<br><br>Hi all,</div><div class="gmail_default" style="font-family:verdana,sans-serif"><br>Here's a short email listing the discussions Cameron, Byron and I had on Friday, 20 Dec.<br>(Unfortunately, Jo and Paul couldn't make it, so we have probably missed insights from the recent doc sprint, but we came up with the following suggestions to get me going over the next few weeks).</div><div class="gmail_default" style="font-family:verdana,sans-serif"><br><b>Documentation tasks (in order of priority)</b></div><div class="gmail_default" style="font-family:verdana,sans-serif"><b><br></b>1. Work on/Update Installation Guide for Windows. </div><div class="gmail_default" style="font-family:verdana,sans-serif"><i>I had some trouble installing GeoNetwork on a Windows machine using the current docs and I thought there was an opportunity to improve these docs for potential users as a quick win.</i><br><br></div><div class="gmail_default" style="font-family:verdana,sans-serif">2. Perform a content audit of existing content (Byron’s spreadsheet) and apply the <a href="https://www.divio.com/blog/documentation/">Divio</a> (4 doc types) against the content to identify doc types. Bryon's spreadsheet gives us a good understanding of where we are in terms of current documentation for the GeoNetwork project and gaps.<br><i>The aim here is to see if we can logically split docs into Tutorials, Howtos, Explanations, and References, which would make them easier to maintain.</i><br><br></div><div class="gmail_default" style="font-family:verdana,sans-serif">3. Set up templates based on content types for developers.<br><i>The aim here is to make it easier for developers, users, tech writers and me to write good docs. There are some best practices getting developed in TheGoodDocsProject which I'm hoping to build upon.</i><br><br><b style="">When/how I plan to tackle this (Timelines)</b><br>End of Dec - Draft of Windows installation guide<br>Jan 1st week - Audit of existing content to match the 4 doc types.<br><br>I'd love to hear everyone's thoughts on this.</div><div class="gmail_default" style="font-family:verdana,sans-serif"><br>Thanks,<br>Swapnil<br></div></div>