[SeasonOfDocs] Proposed: Start a project decision log

[Felicity Brand]

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> 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>
> 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 listSeasonOfDocs at lists.osgeo.orghttps://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
>
> _______________________________________________
> 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/20190804/39e0a63b/attachment.html>