[SeasonOfDocs] What is our vision?

Christopher Pettit c.pettit at unsw.edu.au
Fri May 31 02:37:53 PDT 2019


Jo

I second that vision.

Chris

Sent from my iPhone

On May 31, 2019, at 7:22 PM, Jo Cook <jo.k.cook at gmail.com<mailto:jo.k.cook at gmail.com>> wrote:

As a further vision for the overarching Google Season of Docs project, I would like to add:

"Lowering the barriers for users to contribute to documentation"

Thanks

Jo

On Thu, May 30, 2019 at 9:39 PM Cameron Shorter <cameron.shorter at gmail.com<mailto:cameron.shorter at gmail.com>> wrote:

Our email thread has covered multiple topics, so I've changed the title and am focusing here just on the question of "Vision":

On 30/5/19 10:00 pm, Jared Morgan wrote:
>   Jared Morgan wrote: Do we have a learning vision defined for the project? Where would I
>     find this?

Matteo wrote: what do you mean exactly here? The type of contribution an user wants to
add?

Jared Morgan wrote: Apologies for not being specific enough here. What I'm curious about is whether we have any overarching learning goals that we would like users to get out of existing training modules.

And, if the goals are different for new modules, what would those learning goals be.

I will be open with you all here: I've not got much experience with training material creation. It's something I'd like to learn more about and I think I'm in the right project to get this knowledge.

Great question Jared. Research [1] [2] into open source has identified success metrics to include: "vision" and "opportunity to identify alignment with the community".

Defining a vision is harder than asking. As we don't seem to have a ready answer yet, I suspect we either haven't articulated our vision, or we have room to improve it.

I was hoping to cut-and-paste a clear vision from our OSGeoLive home page, but it appears we have work to do as our vision is spread across multiple places.

OSGeoLive is a self-contained bootable USB or Virtual Machine based on the Lubuntu Linux distribution, that is pre-installed and pre-configured with over 50 of the best GeoSpatial Open Source applications along with sample datasets. It contains clear and consistent Overviews and Quickstarts for each application. This allows people to quickly learn the breadth of OSGeo software, and is regularly used in workshops and training sessions or is being handed out at conferences.

What is our vision for QGIS and GeoNetwork documentation and this Season of Docs initiative? Maybe:

* Clear and intuitive documentation

* Which addresses our key user groups (defined as ???)

* Which covers the breadth of rapidly innovating QGIS and GeoNetwork software

* ... and what else ???

[1] http://cameronshorter.blogspot.com/2018/11/comprehensive-research-into-open-source.html

[2] https://cameronshorter.blogspot.com/2018/12/catching-elusive-episodic-volunteer.html

--
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
_______________________________________________
SeasonOfDocs mailing list
SeasonOfDocs at lists.osgeo.org<mailto:SeasonOfDocs at lists.osgeo.org>
https://lists.osgeo.org/mailman/listinfo/seasonofdocs
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190531/71ad3e43/attachment-0001.html>


More information about the SeasonOfDocs mailing list