[SeasonOfDocs] Proposed: Start a project decision log

[Clarence Cromwell]

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> 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 | she/her
>> 
>> 
>> 
>> _______________________________________________
>> 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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/seasonofdocs/attachments/20190803/c3dd5511/attachment.html>