<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>I've inserted an alternative table format at the bottom of:</p>
<p><a
href="https://github.com/thegooddocsproject/governance/wiki/Decision-Log-2019">https://github.com/thegooddocsproject/governance/wiki/Decision-Log-2019</a></p>
<p>Proposed changes:</p>
<p>* Table format, one row per decision.</p>
<p>* Links to email archive</p>
<p>* YYYY-MM-DD date digit format (which sorts easily if we need to
sort later)</p>
<p>* Dropped reference to "Proposer" for two reasons:</p>
<p>1. It adds extra work, and we should try for simplicity.</p>
<p>2. Recognising the one proposer is usually not indicative of how
good decisions are made. The best decisions are typically made
after input from multiple people.</p>
<p>3. When we create something that can be measured (like who
proposes the most ideas), us humans have a tendency to "chase the
points" which is often at odds with the benefit of the community.
(This is subtle dynamics I've observed in open source communities,
and also reflected in the literature). <br>
</p>
<p>4. We can find out who raised motions in email threads if we
really need to look.<br>
</p>
<div class="moz-cite-prefix">On 14/8/19 7:45 am, Jared Morgan wrote:<br>
</div>
<blockquote type="cite"
cite="mid:CAFCxV17qzs+LVdrmYYS=_UykBOuyGFqfb5zLCUS1Utb1mnZ1uw@mail.gmail.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<div dir="auto">I like the level of detail, Erin. I think the only
thing missing is the link it to the related mailing list thread
tying the two together.</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Wed., 14 Aug. 2019, 07:19
Erin McKean, <<a href="mailto:emckean@google.com"
moz-do-not-send="true">emckean@google.com</a>> wrote:<br>
</div>
<blockquote class="gmail_quote" style="margin:0 0 0
.8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">Hi folks!
<div><br>
The decision log wiki page is here: <a
href="https://github.com/thegooddocsproject/governance/wiki/Decision-Log-2019"
target="_blank" rel="noreferrer" moz-do-not-send="true">https://github.com/thegooddocsproject/governance/wiki/Decision-Log-2019</a></div>
<div><br>
</div>
<div>I figured we'd have to version it eventually so I
thought yearly version is probably the right level of
granularity. Please let me know if not! </div>
<div><br>
</div>
<div>I'd love feedback on this. Is it readable? Does it
capture what we need? </div>
<div><br>
</div>
<div>If the consensus is yes, use the wiki pages, then I
will move the rest of the stuff from the spreadsheet ( <a
href="https://docs.google.com/spreadsheets/d/1fhYL7VqUAzL9_K22G6GS9leK-Yd-XRQdWh9IU1LLF9U/edit?pli=1#gid=0"
target="_blank" rel="noreferrer" moz-do-not-send="true">https://docs.google.com/spreadsheets/d/1fhYL7VqUAzL9_K22G6GS9leK-Yd-XRQdWh9IU1LLF9U/edit?pli=1#gid=0</a>)
to the log.</div>
<div><br>
</div>
<div>Thanks!<br>
<br>
Erin</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Tue, Aug 6, 2019 at
12:48 PM Cameron Shorter <<a
href="mailto:cameron.shorter@gmail.com" target="_blank"
rel="noreferrer" moz-do-not-send="true">cameron.shorter@gmail.com</a>>
wrote:<br>
</div>
<blockquote class="gmail_quote" style="margin:0px 0px 0px
0.8ex;border-left:1px solid
rgb(204,204,204);padding-left:1ex">
<div bgcolor="#FFFFFF">
<p>Thanks Felicity,</p>
<p>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:</p>
<p>* Date Decided (or "Pending")</p>
<p>* Motion</p>
<p>* Discussion (which links to email discussion, and
optionally includes summary)</p>
<p>In row 2 of your spreadsheet, I've provided more
detailed suggestions:</p>
<p><a
href="https://docs.google.com/spreadsheets/d/1fhYL7VqUAzL9_K22G6GS9leK-Yd-XRQdWh9IU1LLF9U/edit#gid=0"
target="_blank" rel="noreferrer"
moz-do-not-send="true">https://docs.google.com/spreadsheets/d/1fhYL7VqUAzL9_K22G6GS9leK-Yd-XRQdWh9IU1LLF9U/edit#gid=0</a></p>
<p>We can remove row after discussion.</p>
<p>Cameron<br>
</p>
<div>On 4/8/19 1:26 pm, Felicity Brand wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">Turns out making a decision log is
really BORING - who knew?!
<div><br>
</div>
<div>I have made a start. Here is a Google Sheet: <a
href="https://docs.google.com/spreadsheets/d/1fhYL7VqUAzL9_K22G6GS9leK-Yd-XRQdWh9IU1LLF9U/edit?usp=sharing"
target="_blank" rel="noreferrer"
moz-do-not-send="true">https://docs.google.com/spreadsheets/d/1fhYL7VqUAzL9_K22G6GS9leK-Yd-XRQdWh9IU1LLF9U/edit?usp=sharing</a> </div>
<div><br>
</div>
<div>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.</div>
<div><br>
</div>
<div>Cheers</div>
<div>Felicity</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Sun, Aug 4,
2019 at 1:05 AM Clarence Cromwell <<a
href="mailto:clarencewcromwell@gmail.com"
target="_blank" rel="noreferrer"
moz-do-not-send="true">clarencewcromwell@gmail.com</a>>
wrote:<br>
</div>
<blockquote class="gmail_quote" style="margin:0px
0px 0px 0.8ex;border-left:1px solid
rgb(204,204,204);padding-left:1ex">
<div 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="m_-1750705548936617184gmail-m_-3602066535861373084gmail-m_-2368319392658243552AppleMailSignature"
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"
target="_blank" rel="noreferrer"
moz-do-not-send="true">cameron.shorter@gmail.com</a>>
wrote:<br>
<br>
</div>
<blockquote type="cite">
<div dir="ltr">
<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>On 3/8/19 7:52 am, Erin McKean
wrote:<br>
</div>
<blockquote type="cite">
<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">
<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" rel="noreferrer"
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></fieldset>
<pre>_______________________________________________
SeasonOfDocs mailing list
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank" rel="noreferrer" moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" target="_blank" rel="noreferrer" moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a>
</pre>
</blockquote>
<pre 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"
target="_blank" rel="noreferrer"
moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a></span><br>
<span><a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs"
target="_blank" rel="noreferrer"
moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a></span><br>
</div>
</blockquote>
</div>
</div>
</div>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org"
target="_blank" rel="noreferrer"
moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a><br>
<a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs"
rel="noreferrer noreferrer" target="_blank"
moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote>
</div>
<br>
<fieldset></fieldset>
<pre>_______________________________________________
SeasonOfDocs mailing list
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank" rel="noreferrer" moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a>
<a href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs" target="_blank" rel="noreferrer" moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a>
</pre>
</blockquote>
<pre cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</div>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org"
target="_blank" rel="noreferrer" moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a><br>
<a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs"
rel="noreferrer noreferrer" target="_blank"
moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote>
</div>
<br clear="all">
<div><br>
</div>
-- <br>
<div dir="ltr" class="m_-1750705548936617184gmail_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"
rel="noreferrer" 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>
_______________________________________________<br>
SeasonOfDocs mailing list<br>
<a href="mailto:SeasonOfDocs@lists.osgeo.org" target="_blank"
rel="noreferrer" moz-do-not-send="true">SeasonOfDocs@lists.osgeo.org</a><br>
<a
href="https://lists.osgeo.org/mailman/listinfo/seasonofdocs"
rel="noreferrer noreferrer" target="_blank"
moz-do-not-send="true">https://lists.osgeo.org/mailman/listinfo/seasonofdocs</a><br>
</blockquote>
</div>
</blockquote>
<pre class="moz-signature" cols="72">--
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant
M +61 (0) 419 142 254</pre>
</body>
</html>