doc/rados/operations/crush-map: warn off manual crush map edits

Signed-off-by: Sage Weil <sage@redhat.com>

diff --git a/doc/rados/operations/crush-map.rst b/doc/rados/operations/crush-map.rst
index 95436076722be9f58d4b755c16925453e4c7af39..76f6519b947d303db6f2a0576b883cdd2db1ee8e 100644 (file)
--- a/doc/rados/operations/crush-map.rst
+++ b/doc/rados/operations/crush-map.rst
@@ -95,8 +95,17 @@ where the cluster name is typically 'ceph', the id is the daemon
 identifier (the OSD number), and the daemon type is typically ``osd``.
 
 
-Editing a CRUSH Map
-===================
+Manually editing a CRUSH Map
+============================
+
+.. note:: Manually editing the CRUSH map is considered an advanced
+         administrator operation.  All CRUSH changes that are
+         necessary for the overwhelming majority of installations are
+         possible via the standard ceph CLI and do not require manual
+         CRUSH map edits.  If you have identified a use case where
+         manual edits *are* necessary, consider contacting the Ceph
+         developers so that future versions of Ceph can make this
+         unnecessary.
 
 To edit an existing CRUSH map: