Release notes 4.0: Fill up data for some topics in performance

Change-Id: I04c41296f878d6e2d94344b621733f7c7f07c337
Signed-off-by: Poornima G <pgurusid@redhat.com>

1 files changed, 29 insertions, 11 deletions

diff --git a/doc/release-notes/4.0.0.md b/doc/release-notes/4.0.0.md
index 7e1be513e0c..5b7211a12aa 100644
--- a/doc/release-notes/4.0.0.md
+++ b/doc/release-notes/4.0.0.md
@@ -94,29 +94,47 @@ Disperse translator, now forwards the request to one of the bircks that is
 deemed to have a good copy, instead of all, thus improving the efficiency of the
 operation.
 
-#### 2. To make md-cache capable to serve nameless lookup
+#### 2. Allow md-cache to serve nameless lookup from cache
+With this enhancement, some more lookups will be served from the cache. The workloads
+that will perform better with this change are:
+- Directory listing in FUSE mount with ACL enabled, will be faster.
+- NFS workloads also will be benifited.
+
 **Notes for users:**
-- https://github.com/gluster/glusterfs/issues/232
-- Release notes:
-    - Need to have some detail on what workloads will stand to gain by this change
+Issue: https://github.com/gluster/glusterfs/issues/232
+There is no specific option to enable this feature, it the default behaviour
+when metadata caching is enabled. To enable metadata caching please refet to
+Performance Tuning section in Admin Guide.
 
 **Limitations:**
-
+None
 
 **Known Issues:**
+None
 
 #### 3. md-cache: Allow runtime addition of xattrs to the list of xattrs that md-cache caches
+   Md-cache caches the stat and xattrs on the client side. In all the previous releases, the
+list of xattrs that can be cached in the client side was hardcoded in the libraries, user could
+only enable or disable the prelisted xattrs cache. With this feature, we can add new xattrs to
+the list of xattrs that can be cached on the client side.
+
 **Notes for users:**
-- https://github.com/gluster/glusterfs/issues/297
-- Needs user documentation for option performance.xattr-cache-list
-- Release notes:
-    - Need documentation of the option, and also some details of when to use this feature
-    - Maybe better if this appeared in the documentation and we could point to the same
+Issue: https://github.com/gluster/glusterfs/issues/297
+To add xattrs to the cache list, execute the following command:
+    ```
+    # gluster volume set <volname> xattr-cache-list "comma separated xattr list"
+    ```
+The option like "cache-samba-metadata" "cache-swift-metadata" which also adds some xattrs
+to the cache list, still works. The new option "xattr-cache-list" appends to the list
+generated by the old options. Refer to the Performance Tuning section in the Admin Guide
+for further information.
 
 **Limitations:**
-
+Currently, setting this option overwrites the previous value set for this option.
+The append to the existing list of xattr is currently not available
 
 **Known Issues:**
+None
 
 #### 4. Cache last stripe of an EC volume while write is going on
 **Notes for users:**