Incorporating sebastian-philipp's suggestions.

Signed-off-by: Zac Dover <zac.dover@gmail.com>

diff --git a/doc/mgr/orchestrator.rst b/doc/mgr/orchestrator.rst
index ac5a40b79a69af51831feba15dab1adf6accc3e8..602538699ca1dd3a23ca040e359f25c4b01044ea 100644 (file)
--- a/doc/mgr/orchestrator.rst
+++ b/doc/mgr/orchestrator.rst
@@ -107,36 +107,15 @@ Example::
 Erase Devices (Zap Devices)
 ---------------------------
 
-Erase (zap) a device so it can be re-used.
+Erase (zap) a device so that it can be resued. ``zap`` calls ``ceph-volume zap`` on the remote host.
 
 ::
 
-     orch device zap
+     orch device zap <hostname> <path>
 
 Example command::
 
-     ceph orch device zap my_hostname my_path true
-
-Parameters::
-
-    hostname: (string)
-
-    path: (string)
-
-    force: CephBool
-
-Ceph Module::
-
-    mgr
-
-Required Permissions::
-
-    rw
-
-Command Flags::
-
-    mgr
-
+     ceph orch device zap my_hostname /dev/sdx
 
 
 Create OSDs