Next steps for GeoNetwork docs using Season of Docs

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

Next steps for GeoNetwork docs using Season of Docs

Cameron Shorter

Hi folks,

In case you are unaware, OSGeo was allocated two Google Summer of Code technical writer slots, of which the GeoNetwork project has been allocated one, Swapnil Ogale, with GeoNetwork mentoring coming from Byron, Jo, Paul, Maria, and a little Season of Docs / OSGeo legwork from me.

Some background work has been done auditing docs, creating a windows quickstart and creating howto and tutorial templates.

We have month left for Season of Docs, and we want to make sure we can make good use of Swapnil's remaining time. (His wrap up week starts 24 Feb).

If you have some bandwidth - we'd love Swapnil's writing experience to amplify your GeoNetwork doc experience.

Where to start:
* Howto Template: https://docs.google.com/document/d/1lSoAf9vDeuSvsF6snCDKsIvFpiSJV8_ouXs_ovrXWWA/
* Tutorial Template: https://docs.google.com/document/d/1hMG2pcc-Dl0I_9ut7FUvNQxAu6Oe_qjh0QC61pv7lvI/
* List of GeoNetwork Docs (and doc status): https://docs.google.com/spreadsheets/d/1l5FwIj5wpr7QUGsmVNJsvvK5KenMEhHmdL_svfeqDXk/edit?ouid=110542442124937335472&usp=sheets_home&ths=true

(Templates should be moved to git within next week and address any feedback provided.)

You could:
* Provide track changes on a specific doc which needs improvement. Doc updates can be provided in git or track changes in google docs or similar. (We hope to add a Feedback form to our doc that can be used soon.)
* Update an existing tutorial or howto (or write a new one) based on templates above.
* Confirm an existing howto or tutorial is still technically correct.

You don't need to be an excellent writer - for the next month we have a technical writer who can help with that.

How Swapnil will help us:

* For next month, Swapnil will be reviewing howtos and quickstarts we update and provide to him.

Are you interested? If so, please speak up.

Warm regards,

-- 
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant

M +61 (0) 419 142 254


_______________________________________________
GeoNetwork-devel mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork