<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 <<a href="mailto:eliventer@gmail.com">eliventer@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">I think <a href="http://docs.gluster.org" rel="noreferrer" target="_blank">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">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>
________<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">https://meet.google.com/cpu-eiue-hvk</a><br>
Gluster-users mailing list<br>
<a href="mailto:Gluster-users@gluster.org" target="_blank">Gluster-users@gluster.org</a><br>
<a href="https://lists.gluster.org/mailman/listinfo/gluster-users" rel="noreferrer" target="_blank">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>