<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <p><br>
    </p>
    <div class="moz-cite-prefix">On 14/11/20 3:23 am, Mahdi Adnan wrote:<br>
    </div>
    <blockquote type="cite"
cite="mid:CABUAFY08zjqvHtjm2-14R2ixxFgcDauwqaGjV5UdVuuDC6xpig@mail.gmail.com">
      <meta http-equiv="content-type" content="text/html; charset=UTF-8">
      <div dir="ltr">Hi,
        <div><br>
        </div>
        <div> Differently, the Gluster docs missing quite a bit
          regarding the available options that can be used in the
          volumes.</div>
        <div>Not only that, there are some options that might
          corrupt data and do not have proper documentation, for
          example, disable Sharding will lead to data corruption and I
          think it does not give any warning? "maybe I'm wrong
          regarding the warning tho" and I can not find any details
          about it in the official Gluster docs. The same goes for
          multiple clients accessing a volume with Sharding enabled.</div>
        <div>also, in some cases, write-behind and stat-prefetch can
          lead to data inconsistency if multiple clients accessing the
          same data.</div>
        <div>I think having solid "Official" Gluster docs with all of
          these details is essential to have stable Gluster deployments.</div>
      </div>
      <br>
      <div class="gmail_quote">
        <div dir="ltr" class="gmail_attr">On Thu, Nov 12, 2020 at 7:34
          PM Eli V &lt;<a href="mailto:eliventer@gmail.com"
            moz-do-not-send="true">eliventer@gmail.com</a>&gt; 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">I
          think <a href="http://docs.gluster.org" rel="noreferrer"
            target="_blank" moz-do-not-send="true">docs.gluster.org</a>
          needs a section on the available parameters,<br>
          especially considering how important some of them can be. For
          example<br>
          a google for performance.parallel-readdir, or<br>
          features.cache-invalidation only seems to turn up some hits in
          the<br>
          release notes on <a href="http://docs.gluster.org"
            rel="noreferrer" target="_blank" moz-do-not-send="true">docs.gluster.org</a>.
          I woudn't expect a new user to have<br>
          to go read the release notes for all previous releases to
          understand<br>
          the importance of these parameters, or what paremeters even
          exist.<br>
        </blockquote>
      </div>
    </blockquote>
    <p><br>
    </p>
    <p><a class="moz-txt-link-freetext" href="https://docs.gluster.org/en/latest/">https://docs.gluster.org/en/latest/</a>  can be updated by sending
      pull requests to <a class="moz-txt-link-freetext" href="https://github.com/gluster/glusterdocs">https://github.com/gluster/glusterdocs</a>. It would
      be great if you can send some patches regarding the changes you
      would like to see. It doesn't have to be perfect. I can help in
      getting them reviewed and merged.</p>
    Thanks,<br>
    Ravi<br>
    <p><br>
    </p>
    <blockquote type="cite"
cite="mid:CABUAFY08zjqvHtjm2-14R2ixxFgcDauwqaGjV5UdVuuDC6xpig@mail.gmail.com">
      <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">
          ________<br>
          <br>
          <br>
          <br>
          Community Meeting Calendar:<br>
          <br>
          Schedule -<br>
          Every 2nd and 4th Tuesday at 14:30 IST / 09:00 UTC<br>
          Bridge: <a href="https://meet.google.com/cpu-eiue-hvk"
            rel="noreferrer" target="_blank" moz-do-not-send="true">https://meet.google.com/cpu-eiue-hvk</a><br>
          Gluster-users mailing list<br>
          <a href="mailto:Gluster-users@gluster.org" target="_blank"
            moz-do-not-send="true">Gluster-users@gluster.org</a><br>
          <a
            href="https://lists.gluster.org/mailman/listinfo/gluster-users"
            rel="noreferrer" target="_blank" moz-do-not-send="true">https://lists.gluster.org/mailman/listinfo/gluster-users</a><br>
        </blockquote>
      </div>
      <br clear="all">
      <div><br>
      </div>
      -- <br>
      <div dir="ltr" class="gmail_signature">
        <div dir="ltr">Respectfully
          <div>Mahdi</div>
        </div>
      </div>
      <br>
      <fieldset class="mimeAttachmentHeader"></fieldset>
      <pre class="moz-quote-pre" wrap="">________



Community Meeting Calendar:

Schedule -
Every 2nd and 4th Tuesday at 14:30 IST / 09:00 UTC
Bridge: <a class="moz-txt-link-freetext" href="https://meet.google.com/cpu-eiue-hvk">https://meet.google.com/cpu-eiue-hvk</a>
Gluster-users mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Gluster-users@gluster.org">Gluster-users@gluster.org</a>
<a class="moz-txt-link-freetext" href="https://lists.gluster.org/mailman/listinfo/gluster-users">https://lists.gluster.org/mailman/listinfo/gluster-users</a>
</pre>
    </blockquote>
  </body>
</html>