[SeasonOfDocs] GeoNetwork Docs meeting notes

[Jo Cook]

Hi Swapnil

This looks good to me. It might be worth comparing it to what we (I started
and Felicity finished) did for the OSGeo:Live Geonetwork quickstart here:
https://live.osgeo.org/en/quickstart/geonetwork_quickstart.html as a
focused example. Is there anything you'd change in that guide to make it
fit with your template, or for any other reason?

All the best

Jo

On Wed, Jan 29, 2020 at 12:49 PM Swapnil Ogale <swapnilogale at gmail.com>
wrote:

> Hi all,
>
> I've added a new template for Tutorials:
> https://docs.google.com/document/d/1hMG2pcc-Dl0I_9ut7FUvNQxAu6Oe_qjh0QC61pv7lvI/edit?usp=sharing
>
> Can you please review this and we can discuss this tomorrow?
>
> Thanks,
> Swapnil
>
> On Mon, 20 Jan 2020 at 23:33, Swapnil Ogale <swapnilogale at gmail.com>
> wrote:
>
>> Thanks for the notes Cameron.
>>
>> As discussed, I've had a go at putting together some info for a How-To
>> article:
>> https://docs.google.com/document/d/1lSoAf9vDeuSvsF6snCDKsIvFpiSJV8_ouXs_ovrXWWA/edit?usp=sharing
>> (I've also added an example using the template in the same doc)
>>
>> Can you please review this and let me know what you think?
>>
>> Meanwhile, I'll keep working on updating Byron's spreadsheet on
>> identifying the gaps.
>>
>> Cheers,
>> Swapnil
>>
>> On Thu, 16 Jan 2020 at 21:12, Cameron Shorter <cameron.shorter at gmail.com>
>> wrote:
>>
>>> Present: Swapnil Ogale, Jo Cook, Paul van Genuchten, Byron Cochrain,
>>> Maria Aras de Rayna
>>>
>>> Swapnil has reviewed Windows getting started documentation, and has
>>> worked out how to get it working. He will be submitting changes.
>>>
>>> In list of documents [1] Swapnil has categorised "Current Content Type"
>>> pages as per key doc types[2]. Next, Swapnil plans to categorise pages
>>> into "Ideal Document Types" and enable finding gaps.
>>>
>>> Maria noted that to date, most documentation has been developed by
>>> individuals without much collaboration. She thinks it valuable to
>>> provide a template which people can write against and collaborate around.
>>>
>>> Paul/Maria noted that there is an extensive translations of GeoNetwork
>>> docs. We considered limiting doc changes due to impact on translations.
>>> However, with Maria's blessing, we feel that it is best to have at least
>>> one excellent set of English docs, and it is then up to the translators
>>> to keep up.
>>>
>>> Jo suggested that we should suggest that translators wait for a set
>>> milestone and doc baseline before translating. Eg: wait until Swapnil
>>> finishes SeasonOfDocs stint. (Final week is 24 Feb 2020).
>>>
>>> If Paul is right about there being a healthy community of translators,
>>> some of these people might be able to help improve existing docs if we
>>> provide a suitable template to follow. Paul said he'd follow up on this.
>>>
>>> Swapnil volunteered to convert an existing doc to an exemplar doc, using
>>> TheGoodDocsProject [3] [4] as a guide (note that it is still alpha and
>>> might not fit well with GeoNework). Swapnil will focus on a Howto first,
>>> then move to a Tutorial.
>>>
>>> Once an exemplar is in place, Swapnil will invite others to review. I'll
>>> review, hope others will too.
>>>
>>> After the review, Paul and Maria offered to test writing against the
>>> exemplar / template. Byron is interested in writing Tutorials, which
>>> could be against the template too.
>>>
>>> Jo will update the calendar invite - next meeting in 2 weeks. It appears
>>> some people's calendars need refreshing.
>>>
>>> [1] List of geonetwork doc pages and their status
>>>
>>> https://docs.google.com/spreadsheets/d/1l5FwIj5wpr7QUGsmVNJsvvK5KenMEhHmdL_svfeqDXk/edit#gid=1668835383
>>>
>>> [2] The four key doc types https://www.divio.com/blog/documentation/
>>>
>>> [3] The Good Docs Project Templates 0.1 in Google Docs:
>>> https://drive.google.com/drive/folders/1Z-UORVQp9TXxU94SphfMh1UkmE7yEom8
>>>
>>> [4] The Good Docs Project Templates more recent source (view raw source
>>> to see comments):
>>> https://github.com/thegooddocsproject/templates/tree/master/how-to
>>>
>>>
>>> --
>>> Cameron Shorter
>>> Technology Demystifier
>>> Open Technologies and Geospatial Consultant
>>>
>>> M +61 (0) 419 142 254
>>>
>>> _______________________________________________
> SeasonOfDocs mailing list
> SeasonOfDocs at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>


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