[SeasonOfDocs] Suggested slack message

Cameron Shorter cameron.shorter at gmail.com
Sun Jun 16 18:29:17 PDT 2019


I love your rewording Felicity. I'll leave it to Jo to make the final call.
Jo was planning to send the message out today, as she was out for the
weekend.

I agree that we need a name for the "DocTemplates" project, and then we can
create a landing page as <name>.github.org . We probably want to take a few
weeks to discuss and find the perfect name.
In the meantime, I suggest we continue using the OSGeo wiki link for this
first message. You might have ideas on how we can temporarily improve the
text at
https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Best_practice_templates


On Mon, 17 Jun 2019 at 11:14, Felicity Brand <felicitybrand at gmail.com>
wrote:

> Hi Cameron and Jo,
>
> It looks like you haven't posted this in Slack yet, am I right?
>
> I think it looks good. My only query is around the stipend statement - I
> think it's muddying the water here.
> My understanding of the stipend is that writers can choose to either
> opt-in (or out) when they submit their proposal - and will get paid upon
> successful completion of their project work.
>
> This blurb could finish nicely at the word "momentum" and follow up with
> the hyperlink.
>
> --------------------------------
>
> Are you a tech writer keen to help build a suite of writing templates,
> technical instructions, and best-practice guidelines for open source
> projects? By making an open project in its own right we want to get the
> biggest reach we can.
> Are you interested? We already have 10+ techies and a few writers
> volunteering, and are building a good momentum. Details at:
>
> https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Best_practice_templates
>
> -----------------------------
>
> Then I re-wrote it to the below - which may or may not hit the mark:
> ---------------------------------
>
>
> Season of Docs is making us think bigger!
> We want to create an open source Documentation Project to establish a
> library of broadly applicable templates for the open source community.
> Are you a tech writer keen to help build a suite of writing templates,
> technical instructions, and best-practice guidelines for open source
> projects? We want to hear from you.
> We already have writers, techies and devs volunteering, so momentum is
> building. Come and get involved!
>
> Details at:
> https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Best_practice_templates
>
> ---------------------------------
>
> It also makes me think that we need a hyperlink that isn't embedded in the
> OSGeo ecosystem. So perhaps we create some kind of lite landing page first
> before we spruik - to give folks a place to register interest. Yes/No?
>
> Also, if I have understood correctly about what we're trying to do...we're
> gonna need a *name *for the thing.
>
> On Fri, Jun 14, 2019 at 8:30 PM Cameron Shorter <cameron.shorter at gmail.com>
> wrote:
>
>> Yes Jo, that looks good to send out. It will be interesting to see if it
>> attracts interest from the writer community.
>>
>> Cheers, Cameron
>> On 14/6/19 8:11 pm, Jo Cook wrote:
>>
>> Hi Cameron,
>>
>> I'd suggest the following:
>>
>> --------------------------------
>>
>> Are you a tech writer keen to help build a suite of writing templates,
>> technical instructions, and best-practice guidelines for open source
>> projects? By making this an open project in it's own right we want to get
>> the biggest reach we can.
>> Are you interested? We already have 10+ techies and a few writers
>> volunteering, and are building a good momentum, but we haven't heard from
>> someone wanting to commit to the SeasonOfDocs stipend yet. Details at:
>>
>> https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Best_practice_templates
>>
>> Or reach out to me @jo or @cameronshorter.
>>
>> -----------------------------------
>>
>> Thoughts?
>>
>> Jo
>>
>> On Wed, Jun 12, 2019 at 1:18 PM Cameron Shorter <
>> cameron.shorter at gmail.com> wrote:
>>
>>> Hi Jo,
>>>
>>> What do you think of the message below to put on the SeasonOfDocs
>>> #discuss slack channel? You could also send to
>>> seasonofdocs at lists.osgeo.org
>>>
>>> --
>>>
>>> Are you a tech writer keen to help build a suite of writing templates
>>> and instructions for open source projects? There doesn't seem to be
>>> broadly applicable templates, and we suspect they'll need to be built as
>>> an open project. Are you interested? We have 10+ techies and a few
>>> writers volunteering. We haven't heard from someone wanting to commit to
>>> the SeasonOfDocs stipend yet. Details at:
>>>
>>> https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Best_practice_templates
>>>
>>> Or reach out to me @jo or @cameronshorter.
>>>
>>>
>>> --
>>> Cameron Shorter
>>> Technology Demystifier
>>> Open Technologies and Geospatial Consultant
>>>
>>> M +61 (0) 419 142 254
>>>
>>>
>>
>> --
>> ------------------------
>> http://about.me/jocook
>>
>> --
>> Cameron Shorter
>> Technology Demystifier
>> Open Technologies and Geospatial Consultant
>>
>> M +61 (0) 419 142 254
>>
>> _______________________________________________
>> SeasonOfDocs mailing list
>> SeasonOfDocs at lists.osgeo.org
>> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>>
> _______________________________________________
> SeasonOfDocs mailing list
> SeasonOfDocs at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>


-- 
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/20190617/0a7d3f94/attachment.html>


More information about the SeasonOfDocs mailing list