[SeasonOfDocs] GeoNetwork setup on windows - chat notes

[Cameron Shorter]

Swapnil,

As per chat just now:

Re setting up on windows (and writing instructions):

* Let's *not* go down the path of setting up a virtual machine and 
OSGeoLive (at least not yet). If you were to go down that path later, 
the page to start with would be:
https://live.osgeo.org/en/quickstart/virtualization_quickstart.html

* Instead I suggest installing java 8 on windows, then tomcat (or jetty, 
I'm not sure which is better), then the geonetwork.war file. Hopefully 
one of the geonetwork experts watching this thread will add comment - my 
experience is about 10 years old here and shouldn't be trusted.

* Good to hear that you have been going through Byron's spreadsheet of 
docs and cateogising them according to doc type.

* I suggest also start gauging effort and what should be done to the 
docs, so we can get a feel for what is required. Maybe collect this in a 
"Comments" column in the spreadsheet or similar?

* At the end of your project, I think we should give the GeoNetwork 
community an assessment of the quality of their docs, accompanied by a 
recommended list of actions which should be implemented, a possible plan 
for implementing, and an indication of the level of effort required. 
This should help steer future documentation direction.

* Also at the end, we should provide feedback to the documentation 
community, and Google, about the process that should be followed in 
improving open-source documentation. I think the doc audit you are doing 
at the moment is a really important part of this, and we should capture 
lessons learned as we go. (I'm currently sketching this into a doc for 
TheGoodDocsProject at the moment).

Cheers, Cameron

On 2/1/20 10:04 pm, Swapnil Ogale wrote:
> Hi Cameron and Jo,
>
> I started with the installation guide and am still stuck.
> Can we have a quick call to discuss this? I am referring to the OsGeo 
> equivalent here 
> (https://live.osgeo.org/en/quickstart/virtualization_quickstart.html) 
> to relate it to these installation instructions 
> (https://geonetwork-opensource.org/manuals/3.8.x/en/maintainer-guide/installing/index.html). 
> Am I on the right track?
>
> Until I get some clarity, I am not sure I can proceed with this.
>
> Meanwhile, I will skip to the next task (go through Byron's 
> spreadsheet and start classifying these based on the 4 content types 
> from the Divio blog).
>
> Does that sound ok?
>
> Swapnil
>
>
-- 
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant

M +61 (0) 419 142 254

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20200103/276eff97/attachment.html>