[SeasonOfDocs] Suggested slack message

[Jo Cook]

Yes, very happy to go with Felicity's rewording- but I'll change that final
line to:

Details (until we find a proper home for this project) at:
https://wiki.osgeo.org/wiki/Season_of_Docs_Ideas_2019#Best_practice_templates

Sound OK?

Jo


On Mon, Jun 17, 2019 at 2:29 AM Cameron Shorter <cameron.shorter at gmail.com>
wrote:

> 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
>
>
>
> _______________________________________________
> SeasonOfDocs mailing list
> SeasonOfDocs at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>


-- 
------------------------
http://about.me/jocook
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190617/4e6fc9d2/attachment.html>