diff --git a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
index bcb08c80019..40934c049dd 100644
--- a/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
+++ b/hadoop-hdfs-project/hadoop-hdfs/CHANGES.txt
@@ -351,6 +351,9 @@ Release 2.8.0 - UNRELEASED
     HDFS-8187. Remove usage of "-setStoragePolicy" and "-getStoragePolicy" using
     dfsadmin cmd (as it is not been supported) (J.Andreina via vinayakumarb)
 
+    HDFS-8175. Provide information on snapshotDiff for supporting the comparison
+    between snapshot and current status (J.Andreina via vinayakumarb)
+
 Release 2.7.1 - UNRELEASED
 
   INCOMPATIBLE CHANGES
diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/xdoc/HdfsSnapshots.xml b/hadoop-hdfs-project/hadoop-hdfs/src/site/xdoc/HdfsSnapshots.xml
index eba1d807c50..330d00fdef1 100644
--- a/hadoop-hdfs-project/hadoop-hdfs/src/site/xdoc/HdfsSnapshots.xml
+++ b/hadoop-hdfs-project/hadoop-hdfs/src/site/xdoc/HdfsSnapshots.xml
@@ -257,6 +257,10 @@
       <tr><td>fromSnapshot</td><td>The name of the starting snapshot.</td></tr>
       <tr><td>toSnapshot</td><td>The name of the ending snapshot.</td></tr>
     </table></li>
+    <p>
+      Note that snapshotDiff can be used to get the difference report between two snapshots, or between
+      a snapshot and the current status of a directory.Users can use "." to represent the current status.
+    </p>
     <li>Results:
       <table>
         <tr><td>+</td><td>The file/directory has been created.</td></tr>