<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On 11 October 2018 at 18:30, Shyam Ranganathan <span dir="ltr">&lt;<a href="mailto:srangana@redhat.com" target="_blank">srangana@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 10/10/2018 11:20 PM, Atin Mukherjee wrote:<br>
&gt; <br>
&gt; <br>
&gt; On Wed, 10 Oct 2018 at 20:30, Shyam Ranganathan &lt;<a href="mailto:srangana@redhat.com">srangana@redhat.com</a><br>
</span><span class="">&gt; &lt;mailto:<a href="mailto:srangana@redhat.com">srangana@redhat.com</a>&gt;&gt; wrote:<br>
&gt; <br>
&gt;     The following options were added post 4.1 and are part of 5.0 as the<br>
&gt;     first release for the same. They were added in as part of bugs, and<br>
&gt;     hence looking at github issues to track them as enhancements did not<br>
&gt;     catch the same.<br>
&gt; <br>
&gt;     We need to document it in the release notes (and also the gluster doc.<br>
&gt;     site ideally), and hence I would like a some details on what to write<br>
&gt;     for the same (or release notes commits) for them.<br>
&gt; <br>
&gt;     Option: cluster.daemon-log-level<br>
&gt;     Attention: @atin<br>
&gt;     Review: <a href="https://review.gluster.org/c/glusterfs/+/20442" rel="noreferrer" target="_blank">https://review.gluster.org/c/<wbr>glusterfs/+/20442</a><br>
&gt; <br>
&gt; <br>
&gt; This option has to be used based on extreme need basis and this is why<br>
&gt; it has been mentioned as GLOBAL_NO_DOC. So ideally this shouldn&#39;t be<br>
&gt; documented.<br>
&gt; <br>
&gt; Do we still want to capture it in the release notes?<br>
<br>
</span>This is an interesting catch-22, when we want users to use the option<br>
(say to provide better logs for troubleshooting), we have nothing to<br>
point to, and it would be instructions (repeated over the course of<br>
time) over mails.<br>
<br>
I would look at adding this into an options section in the docs, but the<br>
best I can find in there is<br>
<a href="https://docs.gluster.org/en/latest/Administrator%20Guide/Managing%20Volumes/" rel="noreferrer" target="_blank">https://docs.gluster.org/en/<wbr>latest/Administrator%20Guide/<wbr>Managing%20Volumes/</a><br>
<br>
I would say we need to improve the way we deal with options and the<br>
required submissions around the same.<br>
<br></blockquote><div>No argument there. I will take a look and get back on what we can improve in the docs.</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Thoughts?<br>
<br>
&gt; <br>
&gt;     &lt;<a href="https://review.gluster.org/c/glusterfs/+/20442" rel="noreferrer" target="_blank">https://review.gluster.org/c/<wbr>glusterfs/+/20442</a>&gt;<br>
<span class="">&gt; <br>
&gt;     Option: ctime-invalidation<br>
&gt;     Attention: @Du<br>
&gt;     Review: <a href="https://review.gluster.org/c/glusterfs/+/20286" rel="noreferrer" target="_blank">https://review.gluster.org/c/<wbr>glusterfs/+/20286</a><br>
&gt; <br>
&gt;     Option: shard-lru-limit<br>
&gt;     Attention: @krutika<br>
&gt;     Review: <a href="https://review.gluster.org/c/glusterfs/+/20544" rel="noreferrer" target="_blank">https://review.gluster.org/c/<wbr>glusterfs/+/20544</a><br>
&gt; <br>
&gt;     Option: shard-deletion-rate<br>
&gt;     Attention: @krutika<br>
&gt;     Review: <a href="https://review.gluster.org/c/glusterfs/+/19970" rel="noreferrer" target="_blank">https://review.gluster.org/c/<wbr>glusterfs/+/19970</a><br>
&gt; <br>
&gt;     Please send in the required text ASAP, as we are almost towards the end<br>
&gt;     of the release.<br>
&gt; <br>
&gt;     Thanks,<br>
&gt;     Shyam<br>
&gt; <br>
</span>______________________________<wbr>_________________<br>
maintainers mailing list<br>
<a href="mailto:maintainers@gluster.org">maintainers@gluster.org</a><br>
<a href="https://lists.gluster.org/mailman/listinfo/maintainers" rel="noreferrer" target="_blank">https://lists.gluster.org/<wbr>mailman/listinfo/maintainers</a><br>
</blockquote></div><br></div></div>