[SeasonOfDocs] Proposed: Start a project decision log

[Cameron Shorter]

Thanks Felicity,

I reckon the success of a decision log in a volunteer project depends 
upon its ease of use. As such, I suggest simply to only include:

* Date Decided (or "Pending")

* Motion

* Discussion (which links to email discussion, and optionally includes 
summary)

In row 2 of your spreadsheet, I've provided more detailed suggestions:

https://docs.google.com/spreadsheets/d/1fhYL7VqUAzL9_K22G6GS9leK-Yd-XRQdWh9IU1LLF9U/edit#gid=0

We can remove row after discussion.

Cameron

On 4/8/19 1:26 pm, Felicity Brand wrote:
> Turns out making a decision log is really BORING - who knew?!
>
> I have made a start. Here is a Google Sheet: 
> https://docs.google.com/spreadsheets/d/1fhYL7VqUAzL9_K22G6GS9leK-Yd-XRQdWh9IU1LLF9U/edit?usp=sharing 
>
>
> It's got a lot of gaps. I will try and fill it in a bit more when I 
> get more motivation. If anyone feels like adding stuff in, please be 
> my guest.
>
> Cheers
> Felicity
>
> On Sun, Aug 4, 2019 at 1:05 AM Clarence Cromwell 
> <clarencewcromwell at gmail.com <mailto:clarencewcromwell at gmail.com>> wrote:
>
>     A decision log would be a much better history of the project than
>     searching through email. The email archive is going to become
>     large, and searching it for history that you don’t already know
>     about might seem like a forbidding task.
>
>      And the lack of historical info could discourage newcomers by
>     depriving them of any context.
>
>     It would be better for future contributors if we could explain the
>     decision history in a log, and this is important because the
>     project is about better user experience through better documentation.
>
>     At the very least the decisions voted on over the previous week
>     should be summarized in the meeting minutes.
>
>     It would be better to accumulate all the decisions in one place,
>     either by compiling the minutes or by having a consistently
>     formatted decision log.
>
>
>     Sent from my iPhone
>
>     On Aug 2, 2019, at 5:01 PM, Cameron Shorter
>     <cameron.shorter at gmail.com <mailto:cameron.shorter at gmail.com>> wrote:
>
>>     +0 from me.
>>
>>     I think it is a good idea, although I haven't seen it used in
>>     Open Source projects I've been involved in, which makes me
>>     question how important it is if open communities haven't picked
>>     it up.
>>
>>     I'd be inclined to make it super light, to encourage use. Probably:
>>
>>     Date, Motion, Pass/Fail result, a link to the final email in
>>     thread which calls the vote. (If interested, historians can dig
>>     through the email archive.
>>
>>     On 3/8/19 7:52 am, Erin McKean wrote:
>>>     Thanks to a great suggestion from Ríona MacNamara, I'd like to
>>>     propose we start a decision log for the Good Docs project.
>>>
>>>     We are sending a lot of email and it might be hard for people to
>>>     find decisions there or in the meeting notes.
>>>
>>>     General format is description, date, deciders, rationale,
>>>     alternatives considered, followup needed.
>>>
>>>     Thoughts?
>>>
>>>     Thanks!
>>>
>>>     Erin
>>>
>>>     -- 
>>>     Erin McKean | Developer Relations Program Manager, Open Source
>>>     Strategy |emckean at google.com <mailto:emckean at google.com> | she/her
>>>
>>>
>>>     _______________________________________________
>>>     SeasonOfDocs mailing list
>>>     SeasonOfDocs at lists.osgeo.org  <mailto: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 <mailto:SeasonOfDocs at lists.osgeo.org>
>>     https://lists.osgeo.org/mailman/listinfo/seasonofdocs
>     _______________________________________________
>     SeasonOfDocs mailing list
>     SeasonOfDocs at lists.osgeo.org <mailto: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/20190807/6df2b2bc/attachment-0001.html>