[OSGeoLive] Season of Docs initiative
Cameron Shorter
cameron.shorter at gmail.com
Wed Mar 27 12:26:50 PDT 2019
As mentioned earlier, I'm building up an OSGeo based proposal for
"Google Season of Docs".
*
Google Season of Docs
<https://developers.google.com/season-of-docs/>(GSoD) is an initiative
to bring open source and technical writer communities together to write
documentation. Let’s use this initiative as a focal point to attract a
collaborative community to pilot big ideas. In particular:
*
Open source projects face sustainability challenges. How will docs
developed during GSoD be maintained long term?
*
Can a writer’s expertise be amplified to help community users and
developers write good docs?
*
Could best practices developed in one project be amplified to the
greater open source eco-system?
*
I'm wanting to pull together a compelling proposal, by listing a team of
people with a cross section of skills who would amplify the impact of a
technical writer. I'm hoping this team will include:
* 1 Official Google Season of docs tech writer.
* Maybe a few other tech writer volunteers who hear about the project
and jump on board
* Some OSGeo/OSGeoLive developers/users who can help write on a topic we
choose. I'm volunteering for this. So has Johanna Botman. I'm hoping to
find a few more. Astrid, I wonder if you'd be interested in helping with
this?
* Some core OSGeoLive team members who can help with git, the doc build
process, and related issues. Angelos, Vicky, Nicolas, I'm wondering if
you would mind offering your services in this regard?
* It would be good to have a few of our translators offer to advise on
the translation process and potentially offer to translate what is
created into another language as part of our OSGeoLive documentation
pipeline.
If so, I'm hoping you might be able to add your name, background and
interest in this part:
*
People keen to take part:
*
Cameron Shorter: Co-founder and OSGeoLive Project Steering Committee
member. Co-editor of OSGeoLive doc templates and reviewer of most of
the 50 Project Overview and Quickstart documents. Ex-board member of
OSGeo Foundation. Keen to provide connections to our community and
to be practically involved in writing initiatives.
*
Johanna Boltman: Ex-English teacher, IT admin, and user of open
source software as a geospatial officer at a local council. Keen to
be mentored in writing docs.
*
… others?
*
* Doc is at:
https://docs.google.com/document/d/1yriJoybYjsCKhprNLNGGanw8HRA5Z8GhrNrA5RjavUU/edit#heading=h.s584ca6y83ac
Let me know if you need write access to the document.
Warm regards, Cameron
On 14/3/19 6:51 am, Cameron Shorter wrote:
>
> Adam, Victor, great to hear you are interested.
>
> Sergio, good question (re what should we do).
>
>
> I've been considering building out from our OSGeoLive documentation
> pipeline (which 100s of you have contributed to). To date, these have
> only focused on relatively easy documentation types of Project
> Overviews and Quickstarts. But they have been applied consistently to
> ~ 50 OSGeo projects, and have been sustainably maintained and
> translated for close to a decade.
>
>
> Let's extend this pipeline to more challenging documentation types,
> like workshops or tutorials, or maybe even reference docs.
>
>
> Our role would be to define a roadmap of tasks, and then guide a
> technical writer. (There are 3 and 6 month options).
>
>
> I'd be interested to hear suggestions on what these tasks should be.
> Maybe have the writer create an exemplar tutorial set for one project,
> along with specific writing templates and tips, and then provide the
> templates to project developers to make it easier for them to write
> best practice documentation?
>
>
> Warm regards, Cameron
>
>
> On 14/3/19 1:03 am, SERGIO ACOSTAYLARA wrote:
>>
>> Thank you Charlie for bringing this to discussion. Before saying
>> "yes" I'll personally need more information. Or at least an idea of
>> what you have in mind.
>>
>> Regards,
>>
>>
>> Sergio Acosta y Lara
>> Departamento de Geomática
>> Dirección Nacional de Topografía
>> Ministerio de Transporte y Obras Públicas
>> URUGUAY
>> (598)29157933 ints. 20329/20330
>> http://geoportal.mtop.gub.uy/
>
> On 13/3/19 4:31 am, Victor Sunday wrote:
>> Hi Cameron,
>> I am interested,you can get me listed.
>> Victor Sunday
>> Lecturer-Geoinformatics/Environmental Management
>> Department of Geography & Environmental Management
>> University of Port Harcourt
>>
>> On Tue, Mar 12, 2019 at 8:30 AM adam steer <adam.d.steer at gmail.com
>> <mailto:adam.d.steer at gmail.com>> wrote:
>>
>> Hey Cameron - sounds great, I'm officially interested!
>>
>> Cheers,
>> Adam
>>
>> ------------------------------------------------------------------------
>> *De:* GeoForAll <geoforall-bounces at lists.osgeo.org> en nombre de
>> Cameron Shorter <cameron.shorter at gmail.com>
>> *Enviado:* lunes, 11 de marzo de 2019 22:46
>> *Para:* OsGeo, GeoForAll
>> *Asunto:* [Geo4All] GeoForAll and Season of Docs initiative
>> OSGeo education folks,
>> I'm aware that many of you have expertise which crosses across
>> education, writing and geospatial software. I'd be interested to hear
>> who might be interested in bringing that expertise into an OSGeo
>> "Season of Docs" initiative, as per below? (I'm personally keen to
>> get involved).
>>
>> ---------- Forwarded message ---------
>> From: *Cameron Shorter* <cameron.shorter at gmail.com
>> <mailto:cameron.shorter at gmail.com>>
>> Date: Tue, 12 Mar 2019 at 12:36
>> Subject: Fwd: Announcement and thanks to Season of Docs survey
>> respondents: Season of Docs has launched
>> To: OSGeo Discussions <discuss at lists.osgeo.org
>> <mailto:discuss at lists.osgeo.org>>
>>
>>
>> As per below, Google has just launched a Season of Docs program,
>> designed to bring open source and technical writer communities
>> together, to the benefit of both. Awesome! I reckon our OSGeo
>> projects should get involved, and I'm personally keen to be part of
>> it. Anyone else want to join me?
>>
>> ---------- Forwarded message ---------
>> From: *Sarah Maddox* <sarahmaddox at google.com
>> <mailto:sarahmaddox at google.com>>
>> Date: Tue, 12 Mar 2019 at 08:56
>> Subject: Announcement and thanks to Season of Docs survey
>> respondents: Season of Docs has launched
>> To:
>>
>>
>> Thank you for your feedback on the initial proposal of Google’s
>> Season of Docs program! You’re receiving this email because you
>> indicated that you’d like us to send you updates about the program.
>>
>>
>> We’re delighted to announce that we’ve launched the 2019 pilot of
>> Season of Docs. Details are on our website: g.co/seasonofdocs
>> <https://developers.google.com/season-of-docs/>.
>>
>>
>> Season of Docs is a Google program that fosters collaboration between
>> open source projects and technical writers. It’s similar to Summer of
>> Code, but with a focus on documentation and technical writers.
>>
>>
>> Would you like to take part as a mentor in the inaugural year of
>> Season of Docs? Organization applications open on April 2, 2019. See
>> the full timeline
>> <https://developers.google.com/season-of-docs/docs/timeline>and join
>> the announcement group at season-of-docs-announce
>> <https://groups.google.com/group/season-of-docs-announce>to stay
>> informed.
>>
>>
>> Please do tweet and blog about Season of Docs if you’d like to share
>> the news. We want as many people to know about it as possible. We’ve
>> provided logos that you can download and some example content on the
>> press page <https://developers.google.com/season-of-docs/docs/press>.
>>
>>
>> If you have any questions, please email
>> season-of-docs-support at googlegroups.com
>> <mailto:season-of-docs-support at googlegroups.com>.
>>
>>
>> Many thanks again for your valuable feedback on the initial proposal.
>>
>>
>> Sarah Maddox, Andrew Chen, and the Season of Docs team
>>
>>
>>
>>
>> --
>> Cameron Shorter
>> Technology Demystifier
>> Open Technologies and Geospatial Consultant
>>
>> M +61 (0) 419 142 254
>>
>>
>>
>>
>>
>> --
>> Cameron Shorter
>> Technology Demystifier
>> Open Technologies and Geospatial Consultant
>>
>> M +61 (0) 419 142 254
>>
>>
>>
> --
> Cameron Shorter
> Technology Demystifier
> Open Technologies and Geospatial Consultant
>
> M +61 (0) 419 142 254
--
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/osgeolive/attachments/20190328/17d09e7b/attachment-0001.html>
More information about the osgeolive
mailing list