diff --git a/hbase-common/src/main/resources/hbase-default.xml b/hbase-common/src/main/resources/hbase-default.xml
index 23b12bb9c96a..f50ed1ca7a88 100644
--- a/hbase-common/src/main/resources/hbase-default.xml
+++ b/hbase-common/src/main/resources/hbase-default.xml
@@ -768,9 +768,11 @@ possible configurations would overwhelm and obscure the important.
   <property>
     <name>hbase.hregion.max.filesize</name>
     <value>10737418240</value>
-    <description>
-    Maximum HFile size. If the sum of the sizes of a region's HFiles has grown to exceed this
-    value, the region is split in two.</description>
+    <description>Maximum file size. If the sum of the sizes of a region's HFiles has
+      grown to exceed this value, the region is split in two. There are two choices of
+      how this option works, the first is when any store's size exceed the threshold
+      then split, and the other is overall region's size exceed the threshold then split,
+      it can be configed by hbase.hregion.split.overallfiles.</description>
   </property>
   <property>
     <name>hbase.hregion.split.overallfiles</name>
diff --git a/src/main/asciidoc/_chapters/hbase-default.adoc b/src/main/asciidoc/_chapters/hbase-default.adoc
index c51b6109acc2..0a0e4d6c263a 100644
--- a/src/main/asciidoc/_chapters/hbase-default.adoc
+++ b/src/main/asciidoc/_chapters/hbase-default.adoc
@@ -887,8 +887,11 @@ Time to sleep in between searches for work (in milliseconds).
 +
 .Description
 
-    Maximum HFile size. If the sum of the sizes of a region's HFiles has grown to exceed this
-    value, the region is split in two.
+    Maximum file size. If the sum of the sizes of a region's HFiles has
+    grown to exceed this value, the region is split in two. There are two choices of
+    how this option works, the first is when any store's size exceed the threshold
+    then split, and the other is overall region's size exceed the threshold then split,
+    it can be configed by hbase.hregion.split.overallfiles.
 +
 .Default
 `10737418240`