[OSGeo-UK] Geonetwork users?

[Jonathan Moules]

Hi Jo,

Good stuff!

Personally I've always thought the need to do GIT pull-requests to 
update documents was onerous.

Documenters are less likely to be familiar with git and version control, 
and of course git is nothing if not unintuitive (there's a reason many 
of the highest scored and most viewed stackoverflow questions are git 
related). If someone's a serious documenter then the considerable time 
required to get familiar with and install all of the tooling is 
burdensome but do-able. However if someone just spots a few minor 
things, they're unlikely to make the effort.

For my part this certainly applies to me - my version control system of 
choice isn't git so I don't have it installed and I'm not interested in 
getting it, going through the checkout dance, etc, just to correct a few 
typos.

Fortunately this is already a solved problem with wikis, ideally of the 
sort that don't require accounts, although I appreciate that presents 
its own problems.

There's also implications regarding licensing and contributor agreements 
which projects may require. Reading and signing 1000 words of legalese 
is rarely fun even if unfortunately necessary - 
https://www.osgeo.org/resources/individual-contributor-license/

Just my 2p,

Cheers,

Jonathan


On 2019-06-07 12:46, Jo Cook wrote:
> Hi All,
>
> I'm involved with Google Season of Docs this year
> (https://wiki.osgeo.org/wiki/Season_of_Docs_2019). The main focuses
> for us are QGIS, OSGeoLIVE and Geonetwork.  We will be getting a paid
> technical writer for a few months to work on the OSGeo projects
> collectively, but the main aim is to get more community engagement in
> contributing to documentation.
>
> I'm heading up the Geonetwork team, and part of what I'm trying to do
> is lower the barriers for users to contribute to documentation, and
> figure out where information is missing, or how the documentation can
> be improved in other ways.
>
> So this is really a call out to fellow UK Geonetwork users- let me
> know what you think could do with improving in the documentation, and
> also if you're interested in getting further involved with the
> project. Any level of experience in contributing to documentation is
> fine- if you're a beginner and have previously been put off
> contributing or correcting a typo or something, then let me know what
> it is that put you off and we'll see what we can do to help. Contact
> me on or off list!
>
> If QGIS and/or OSGeoLive are more your thing, then head over to the
> Season of Docs mailing list at
> https://lists.osgeo.org/mailman/listinfo/seasonofdocs as there are
> some active discussions going on about training materials and such
> like.
>
> All the best
>
> Jo
>
> --
> Jo Cook
> t:+44 7930 524 155/twitter:@archaeogeek
> Please note that currently I do not work on Friday afternoons. For
> urgent responses at that time, please visit
> support.astuntechnology.com or phone our office on 01372 744009
>