[SeasonOfDocs] Suggested plan for Swapnil's SeasonOfDocs/GeoNetwork work

[Jo Cook]

Hi All,

Firstly sorry for the radio silence, this week I've been travelling,
presenting at a conference, and attending my company's Christmas meeting.
Consequently I've not had chance to process Swapnil's reports on progress
yet. However, one thing I would say is that I'd prefer not to give up on
installing in windows- because that, in itself, signifies a documentation
problem that needs addressing!

I will have more opportunity to focus on this next week, including
potentially attempting to install GeoNetwork on windows 10 myself. I'd like
to review previous comms, and then would people be available for a call
next week some time? There is a Thursday GeoNetwork call already pencilled
in, but I'm aware it's a time that doesn't really work for you guys, so
feel free to suggest a different slot (or even a doodle poll to figure it
out).

All the best

Jo

On Thu, Dec 12, 2019 at 10:30 AM Cameron Shorter <cameron.shorter at gmail.com>
wrote:

> 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.
>
> My suggestions:
>
> * 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.
>
> * I think that Swapnil should start to build up a best practices
> recommended architecture for an Open Source docset (based on
> https://www.divio.com/blog/documentation/ )
>
> * 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).
>
> * This should lead to a very large potential body of documentation work
> to be done, from which Swapnil should focus on specific parts.
>
> * Focus should be on helping amplify the writing effectiveness of
> existing volunteer writers.
>
> * This might involve providing writing templates (which are starting to
> emerge in TheGoodDocsProject)
>
> * 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.
>
> * I know Byron (and others?) have started a doc audit and built a
> spreadsheet.
>
> * 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?
>
> --
> Cameron Shorter
> Technology Demystifier
> Open Technologies and Geospatial Consultant
>
> M +61 (0) 419 142 254
>
>

-- 
------------------------
http://about.me/jocook
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20191213/c60b569c/attachment.html>