[SeasonOfDocs] Geonetwork meeting minutes

[Cameron Shorter]

While TheGoodDocs project will be selecting Markdown for its main 
writing templates, this is because they are both widely used and the 
most limiting of formats (so we can service other markdown types more 
easily.)

However, from my experience with the OSGeoLive project, I've noticed 
that all, or (or almost all) of the OSGeo stack of software use RST, 
which is a richer format. As GeoNetwork is often bundled with other 
projects (such as within GeoNode), I'd suggest continuing to use the 
same RST format as others in order to support doc integration.

At the very least, consult with the other projects first before moving.

Cheers, Cameron

On 8/11/19 2:55 am, Byron Cochrane wrote:
> Sorry I missed the meeting.
> Bit crazy around here. Will catch you next time
>
> Byron
>
> Sent from my iPhone
>
> On 7/11/2019, at 11:58 PM, Jo Cook <jo.k.cook at gmail.com 
> <mailto:jo.k.cook at gmail.com>> wrote:
>
>> Hi List,
>>
>> We had a short meeting about the GeoNetwork Season of Docs project 
>> today, attended by myself and Paul van Genuchten.
>>
>> Main topics:
>>
>> * Discussions about switching the GeoNetwork documentation from 
>> re-structured text format to markdown. There are pros and cons to 
>> both- markdown is generally easier for new contributors, but has less 
>> functionality. Switching will also mean losing the current document 
>> history. It would need to happen at a key release (eg GeoNetwork 4) 
>> to minimise problems in this regard.
>>
>> * Good ways to mark up limitations in the current documentation- I've 
>> been creating issues for pages that need attention, titled (for 
>> example) "Changelog Review (3.x): [Page] with [problem]". It's 
>> important to tie this in to the review spreadsheet that Byron put 
>> together.
>>
>> Next meeting date: November 21st- here's the meeting link: 
>> https://calendar.google.com/event?action=TEMPLATE&tmeid=NXA0dG9lYTJwaWc1bm8xYm5rZnE0NGY0dWtfMjAxOTExMjFUMTAwMDAwWiBqby5rLmNvb2tAbQ&tmsrc=jo.k.cook%40gmail.com&scp=ALL
>>
>> Regards
>>
>> Jo
>>
>> -- 
>> ------------------------
>> http://about.me/jocook
>> _______________________________________________
>> SeasonOfDocs mailing list
>> SeasonOfDocs at lists.osgeo.org <mailto:SeasonOfDocs at lists.osgeo.org>
>> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>
> _______________________________________________
> SeasonOfDocs mailing list
> SeasonOfDocs at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/seasonofdocs

-- 
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/20191108/818a0952/attachment.html>