Blog - Posts tagged governancehttps://www.writethedocs.org/blog/archive/tag/governance/atom.xml2019-10-30T00:00:00ZABlogIntroducing Write the Docs Enhancement Proposalshttps://www.writethedocs.org/blog/introducing-weps/2019-10-30T00:00:00Z2019-10-30T00:00:00ZWrite the Docs Team<div class="section" id="introducing-write-the-docs-enhancement-proposals">
<p>Write the Docs began seven years ago with a single conference.
It has now grown to multiple conferences worldwide,
over 50 international meetups,
and <a class="reference external" href="https://www.writethedocs.org/#join-the-community">many other projects</a>.</p>
<p>We have often followed the open source philosophy in our community practices,
keeping a loose governance model and mostly letting the work speak for itself.
However,
we’ve been experiencing a number of growing pains with this approach.
A loosely defined process makes it much harder for new people to understand and join the community in leadership positions,
since they don’t understand how the community actually works.
Even folks doing a lot of work in the community are often lost or confused when it comes to projects they aren’t directly involved with.</p>
<p>All organizations have power structures,
some are just not documented. <a class="footnote-reference" href="#id2" id="id1">[1]</a>
Instead of trying to reinvent the wheel,
we’ve once again taken an idea from the open source ecosystem:
Write the Docs Enhancement Proposals,
or WEPs.</p>
<div class="section" id="what-is-a-write-the-docs-enhancement-proposal-wep">
<h2>What is a Write the Docs Enhancement Proposal (WEP)</h2>
<p>The WEP system is a formalized process for making major policy changes in the community.
Previously, our governance was usually defined with some kind of fuzzy consensus on a Slack channel or a meeting at a conference.
Going forward, we want to establish a written record that people have time to review and comment on.
Importantly,
there will also be records of the conversation that lead to a change.</p>
<p>We hope that WEPs will make the process of making major changes inside the community more explicit and collaborative.
Any contributors can propose WEPs with a well-defined process,
and the whole community can follow the process of proposing and implementing WEPs.
WEPs are the first major step towards having a more open and defined model for governance,
but certainly not the last.
All further governance changes are planned to go through the WEP process,
so it is truly foundational for future improvements to our community management processes.</p>
</div>
<div class="section" id="what-is-the-wep-process">
<h2>What is the WEP process?</h2>
<p>The WEP process is defined in <a class="reference external" href="https://github.com/writethedocs/weps/pull/1">WEP0</a>,
the first ever WEP.
WEP0 itself is currently ready for review,
following the draft WEP process.
This might appear circular at first glance,
but we hope that it will showcase how the process works as we adopt it.</p>
<p>The high-level overview of the WEP process is as follows,
from the perspective of someone proposing a WEP:</p>
<ol class="arabic simple">
<li>Talk to people about your idea, and get feedback from other community members</li>
<li>Draft and submit a Pull Request on the WEP GitHub Repository, which submits the WEP as a <strong>draft</strong></li>
<li><dl class="first docutils">
<dt>The <strong>WEP team</strong> then reviews the Draft WEP to make sure it falls within the WEP guidelines:</dt><dd><ul>
<li>Is the WEP well-formed? Does it have all the required sections?</li>
<li>Is the WEP specific enough that the outcome of approving it is clear?</li>
<li>Is the proposed change within the scope of the WEP process?</li>
</ul>
</dd>
</dl>
</li>
<li>After the WEP team accepts the draft, it is now <strong>ready-for-discussion</strong>.</li>
<li>The WEP team then sets a deadline for discussion, currently 30 days, for community feedback and review</li>
<li><dl class="first docutils">
<dt>Once the WEP is <strong>ready-for-discussion</strong> and has a deadline, the Core Ops team announce the WEP in a few defined channels, where interested community members can subscribe</dt><dd><ul>
<li>The <code class="docutils literal notranslate"><span class="pre">WEP-announcements</span></code> Slack channel</li>
<li>The <code class="docutils literal notranslate"><span class="pre">WEP-announcements</span></code> Email list</li>
</ul>
</dd>
</dl>
</li>
<li>During this month-long period, the WEP is updated based on incoming feedback, and the community works towards a consensus on the proposed change</li>
<li><dl class="first docutils">
<dt>At the deadline, the Core Ops team determines if consensus has been reached</dt><dd><ul>
<li>If there is consensus, the WEP is <strong>Accepted</strong>, it will be implemented as specified</li>
<li>If there is no consensus, the WEP is either <strong>Rejected</strong> or <strong>Extended</strong> for another month. Extension is available when it seems further activity could lead to consensus.</li>
</ul>
</dd>
</dl>
</li>
<li>Once the WEP decision is made, another announcement is sent to the defined announcement channels</li>
</ol>
</div>
<div class="section" id="get-involved">
<h2>Get involved</h2>
<p>If you want to understand the full policy,
we invite you to review and comment on <a class="reference external" href="https://github.com/writethedocs/weps/pull/1">WEP0</a>.
We also welcome feedback privately via email at <a class="reference external" href="mailto:support%40writethedocs.org">support<span>@</span>writethedocs<span>.</span>org</a> if that is more comfortable for you.
This is a new process,
but we hope it will start to address questions of how change happens in the community.</p>
<p>We hope that you’ll take the time to read our proposal and understand how we’re changing the process of making changes in the community.
The more engaged folks are with the process,
the better the community will be for everyone.</p>
<table class="docutils footnote" frame="void" id="id2" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>A great read if you haven’t already: <a class="reference external" href="https://www.jofreeman.com/joreen/tyranny.htm">https://www.jofreeman.com/joreen/tyranny.htm</a></td></tr>
</tbody>
</table>
</div>
</div>