Incorporating sebastian-philipp's suggestions.

Signed-off-by: Zac Dover <zac.dover@gmail.com>
(cherry picked from commit 845b05419ae870f87c66dcef4858d68e2ec8dd5c)

diff --git a/doc/mgr/orchestrator.rst b/doc/mgr/orchestrator.rst
index 6ee8786f872d346d4617400c901c96c201c80e1b..67f47347789a6b0584304e94e3344a89661cab65 100644 (file)
--- a/doc/mgr/orchestrator.rst
+++ b/doc/mgr/orchestrator.rst
@@ -106,36 +106,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