doc: Add warning that the root directory cannot be fragmented

Documents: #39704

Signed-off-by: Nathan Fish <lordcirth@gmail.com>

diff --git a/doc/cephfs/dirfrags.rst b/doc/cephfs/dirfrags.rst
index 7f42130789c530e8ab7050f8cbedd783d319e4db..d53e0c060667853c69dfcb6dce5895d46881cd9e 100644 (file)
--- a/doc/cephfs/dirfrags.rst
+++ b/doc/cephfs/dirfrags.rst
@@ -18,6 +18,8 @@ remain conservative about creating very large directories, as they still
 have a resource cost in situations such as a CephFS client listing
 the directory, where all the fragments must be loaded at once.
 
+.. tip:: The root directory cannot be fragmented.
+
 All directories are initially created as a single fragment.  This fragment
 may be *split* to divide up the directory into more fragments, and these
 fragments may be *merged* to reduce the number of fragments in the directory.