<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-">&gt;&gt;<br>
&gt;&gt; Further, as we hit end of March, we would make it mandatory for features<br>
&gt;&gt; to have required spec and doc labels, before the code is merged, so<br>
&gt;&gt; factor in efforts for the same if not already done.<br>
&gt;<br>
&gt;<br>
&gt; Could you explain the point above further? Is it just the label or the<br>
&gt; spec/doc<br>
&gt; that we need merged before the patch is merged?<br>
&gt;<br>
<br>
</span>I&#39;ll hazard a guess that the intent of the label is to indicate<br>
availability of the doc. &quot;Completeness&quot; of code is being defined as<br>
including specifications and documentation.<br>
<br></blockquote><div> </div><div>I believe this has originated from maintainers meeting agreements [1] . The proposal to make a spec and documentation mandatory was submitted 3 months back and is documented, and submitted for comment @ <a href="https://docs.google.com/document/d/1AFkZmRRDXRxs21GnGauieIyiIiRZ-nTEW8CPi7Gbp3g/edit?usp=sharing">https://docs.google.com/document/d/1AFkZmRRDXRxs21GnGauieIyiIiRZ-nTEW8CPi7Gbp3g/edit?usp=sharing</a></div><div><br></div><div>The idea is, if the code is going to be released, it should have relevant documentation for users to use it, otherwise, it doesn&#39;t matter if the feature is present or not. If the feature is &#39;default&#39;, and there is no documentation required, just mention it, so the flags can be given. Also, if there is no general agreement about the design, it doesn&#39;t make sense to merge a feature and then someone has to redo things.</div><div><br></div><div>For any experimental code, which we want to publish for other developers to test, who doesn&#39;t need documentation, we have &#39;experimental&#39; branch, which should be used for validation.</div><div><br></div><div> [1] - <a href="http://lists.gluster.org/pipermail/gluster-devel/2017-December/054070.html">http://lists.gluster.org/pipermail/gluster-devel/2017-December/054070.html</a></div></div>
</div></div>