[SeasonOfDocs] The Good Docs Project status meeting 21 August 2019

[Jo Cook]

Hi All,

Sorry for also missing this week's meeting- I had a small surgical
procedure during the day and couldn't quite cope with staying up late! I'm
also away on leave from tomorrow for a week so won't be around for the
meeting next week either.

A quick update on email lists:

I've been in discussion with GitHub Help via twitter and they have made
some suggestions for archiving methods, which I have yet to try out. I've
also been asking them about publicly accessible lists (eg something that is
viewable and searchable without needing to log in to GitHub, though not
actually postable). Unfortunately with that question they seem to have
totally misunderstood what I wanted, so let's just say that discussion is
ongoing. Collectively we've all been teasing out what people can and can't
do with various permissions levels, so I think when I'm back from leave we
can probably decide whether to take this forward or explore other options.

A further action I'd like us to explore is the use of Pull Request
templates to include text about licensing- I'd be happy to take this
forward when I return unless anyone else has bandwidth to look at it now.
While I initially thought probot was really cool, I hadn't considered how
biased it was to terminal use, and how much of a barrier to entry it seemed
to place on people using various GUIs, which seems unsuitable for us in the
short-term at least.

All the best

Jo

On Wed, Aug 21, 2019 at 6:22 PM Erin McKean <emckean at google.com> wrote:

> Hi folks! So sorry to miss the meeting!
>
> Quick update from my end:
>
> * met with the designer to talk through Doctopus logo options. Should have
> something in ~two weeks
> * my legal meeting was rescheduled to Friday, will send update after that
>
>
> I am OOO at an offsite event next Tuesday, I have sent the meeting
> invitation and will do my best to attend!
>
> Thanks again!
>
> Erin
>
> On Tue, Aug 20, 2019 at 4:00 PM Felicity Brand <felicitybrand at gmail.com>
> wrote:
>
>> Notes from today's meeting. Let me know if I captured something
>> incorrectly.
>>
>>
>>
>> Attendees: Cameron, Clarence, Felicity
>>
>>
>> Licensing/Probot/DCO
>>
>> No updates.
>>
>> We want to keep it simple. We don't want barriers to contributing.
>>
>> Clarence talked through his 'How to contribute' document. Let's review
>> it, make it live and start using it. By end of weekend and back into GitHub
>> by next meeting.
>>
>> Action: Cameron to reply to Clarence on the email thread.
>>
>>
>> Email list
>>
>> Jo - No update. Need to be publicly visible and archive-able. Needing to
>> be a GitHub member to contribute might reduce the amount of spam which is a
>> good thing.
>>
>>
>> Logo update
>>
>> Erin - No update
>>
>>
>> Decision log wiki page
>>
>> We looked at the page during the call. We plan to go with the table
>> format - if anyone has any objections, speak up.
>>
>> *Action*: Cameron to add the existing decisions to table format by the
>> end of this weekend.
>>
>>
>> Docsy
>>
>> Erin - No update
>>
>>
>> Style guide/dictionary?
>> Action: Clarence please capture this brief discussion to wrap it up and
>> unless anyone objects, we'll go with Google Style guide and put it in place
>> now.
>>
>> We'll need to link to it from the Contributors guide.
>>
>>
>> Templates
>>
>> There may be many use cases for our templates - for example, documenting
>> an API or a desktop app, and then there is domain specificity.  We don't
>> want to bloat our repo with a whole lot of different flavor templates.
>>
>> We can incorporate our instructional text within the document, with a
>> view to our text being replaced by the template user. We may end up with
>> a lot of text in our templates but as a user, it's much easier to ignore
>> what you don't need.
>>
>> Action: Felicity create Google doc version 0.1 of Quick Start template
>> for us to start building on.
>>
>>
>>
>>
>> _______________________________________________
>> SeasonOfDocs mailing list
>> SeasonOfDocs at lists.osgeo.org
>> https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>>
>
>
> --
> Erin McKean | Developer Relations Program Manager, Open Source Strategy |
> emckean at google.com | she/her
>
> _______________________________________________
> 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/20190822/6bdbf909/attachment-0001.html>