[SeasonOfDocs] Answers to the Application form

[Cameron Shorter]

Hi Jo,

Great to have you on board and good to hear about the interest from the 
GeoNework community.

For next steps:

* Thanks for adding your name to: 
https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Key_roles_sought

* I'd suggest it would help our proposal to have at least one other 
person from GeoNetwork community put their name forward to act as a 
mentor. (Google is asking for at least 2 mentors per senior writer 
provided. Mentors can be technical rather than writers).

* With regards to documentation ideas for GeoNetwork, we will need to 
write them down in a public location (ie here: 
https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Ideas ) I think we 
can build these ideas into something compelling, but I think they need 
to be defined more clearly if we are to be taken seriously. Item 3 
sounds the most compelling. Tutorials are a relatively difficult writing 
concept, and can also be addressed relatively autonomously. It can also 
be done in line with a template which we develop in conjunction with 
QGIS and OSGeoLive. Is someone in a position to explain the gap between 
what is currently in place and what is needed for GeoNetwork?

Item 2) "Fix incomplete docs" could be a task, but it needs to be 
quantified and described.

Item 1) "Review pull requests" sounds quite unstructured and wouldn't be 
making best use of the time of a Senior Technical Writer. It would also 
be difficult to qualify whether the writer has completed their tasks or 
done a good job.

Warm regards, Cameron

On 16/4/19 8:47 pm, Jo Cook wrote:
> Hi All,
>
> I can confirm that I have had a positive response back from the 
> Geonetwork team about participating in this. If that's something we 
> want to pursue, they would like to take the following approach:
>
> 1) Review recent Pull Requests for UI and new features and check that 
> they are documented in the existing documentation
> 2) Complete any areas of documentation that are incomplete (there are 
> some placeholder pages and areas that say TBD)
> 3) Improve or create basic tutorials on how to use standard features, 
> and separate existing tutorials into sections for usage, application 
> development and so on (this is not currently done).
>
> Does this fit with what we want to do with Season of Docs? I will also 
> tentatively put myself forward as the second mentor if no one with 
> more experience steps up- I have never participated in a google 
> project of any kind before.
>
> Regards
>
> Jo
>
> On Wed, Apr 10, 2019 at 9:55 PM Cameron Shorter 
> <cameron.shorter at gmail.com <mailto:cameron.shorter at gmail.com>> wrote:
>
>     I've gone through the Season of Docs application form, and have
>     filled out answers, but not submitted.
>
>     Answers captured
>     here:https://wiki.osgeo.org/wiki/Season_of_Docs_Application_2019
>     <https://wiki.osgeo.org/wiki/Season_of_Docs_Application_2019>
>
>     There are some uncompleted answers, in particular around finding a
>     second mentor (who is up to volunteer?), and describing OSGeo's
>     prior mentor experience (search for TBC).
>
>
>
>     -- 
>     Cameron Shorter
>     Technology Demystifier
>     Open Technologies and Geospatial Consultant
>
>     M +61 (0) 419 142 254
>
>     _______________________________________________
>     SeasonOfDocs mailing list
>     SeasonOfDocs at lists.osgeo.org <mailto:SeasonOfDocs at lists.osgeo.org>
>     https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>
>
>
> -- 
> ------------------------
> http://about.me/jocook

-- 
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/20190416/39317ae3/attachment.html>