<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body dir="auto">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. <div><span style="background-color: rgba(255, 255, 255, 0);"><br></span></div><div><span style="background-color: rgba(255, 255, 255, 0);"> And the lack of historical info could discourage newcomers by depriving them of any context. </span><div><br></div><div>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.</div><div><br></div><div><span style="background-color: rgba(255, 255, 255, 0);">At the very least the decisions voted on over the previous week should be summarized in the meeting minutes. </span></div><div><span style="background-color: rgba(255, 255, 255, 0);"><br></span></div><div><span style="background-color: rgba(255, 255, 255, 0);">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.</span></div><div><br><br><div id="AppleMailSignature" dir="ltr">Sent from my iPhone</div><div dir="ltr"><br>On Aug 2, 2019, at 5:01 PM, Cameron Shorter <<a href="mailto:cameron.shorter@gmail.com">cameron.shorter@gmail.com</a>> wrote:<br><br></div><blockquote type="cite"><div dir="ltr">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<p>+0 from me.</p>
<p>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.</p>
<p>I'd be inclined to make it super light, to encourage use.
Probably:</p>
<p>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.<br>
</p>
<div class="moz-cite-prefix">On 3/8/19 7:52 am, Erin McKean wrote:<br>
</div>
<blockquote type="cite" cite="mid:CAKeUqU7p_4FjWch2xjKJg8-_rsnENvHO_5AScZEf4ULz2T7ZqA@mail.gmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<div dir="ltr">Thanks to a great suggestion from Ríona MacNamara,
I'd like to propose we start a decision log for the Good Docs
project.
<div><br>
We are sending a lot of email and it might be hard for people
to find decisions there or in the meeting notes.</div>
<div><br>
</div>
<div>General format is description, date, deciders, rationale,
alternatives considered, followup needed.</div>
<div><br>
</div>
<div>Thoughts?</div>
<div><br>
</div>
<div>Thanks!<br>
<br>
Erin</div>
<div>
<div><br>
</div>
-- <br>
<div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature">
<div dir="ltr">
<div>
<div dir="ltr">
<div style="line-height:1.5em;padding-top:10px;margin-top:10px;color:rgb(85,85,85);font-family:sans-serif"><span style="border-width:2px 0px
0px;border-style:solid;border-color:rgb(213,15,37);padding-top:2px;margin-top:2px">Erin
McKean |</span><span style="border-width:2px 0px
0px;border-style:solid;border-color:rgb(51,105,232);padding-top:2px;margin-top:2px"> Developer
Relations Program Manager, Open Source Strategy |</span><span style="border-width:2px 0px
0px;border-style:solid;border-color:rgb(0,153,57);padding-top:2px;margin-top:2px"> <a href="mailto:emckean@google.com" target="_blank" moz-do-not-send="true">emckean@google.com</a> |</span><span style="border-width:2px 0px
0px;border-style:solid;border-color:rgb(238,178,17);padding-top:2px;margin-top:2px"> she/her</span></div>
<br>
</div>
</div>
</div>
</div>
</div>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
SeasonOfDocs mailing list
<a class="moz-txt-link-abbreviated" href="mailto:SeasonOfDocs@lists.osgeo.org">SeasonOfDocs@lists.osgeo.org</a>
<a class="moz-txt-link-freetext" href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a>
</pre>
</blockquote>
<pre class="moz-signature" cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</div></blockquote><blockquote type="cite"><div dir="ltr"><span>_______________________________________________</span><br><span>SeasonOfDocs mailing list</span><br><span><a href="mailto:SeasonOfDocs@lists.osgeo.org">SeasonOfDocs@lists.osgeo.org</a></span><br><span><a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a></span><br></div></blockquote></div></div></body></html>