diff --git a/doc/mgr/orchestrator.rst b/doc/mgr/orchestrator.rst
index 6d86ad83cb1..440961f1b7d 100644
--- a/doc/mgr/orchestrator.rst
+++ b/doc/mgr/orchestrator.rst
@@ -406,7 +406,7 @@ Placement by pattern matching
 
 Daemons can be placed on hosts as well::
 
-    orch apply prometheus '*'
+    orch apply prometheus 'myhost[1-3]'
 
 Or in yaml:
 
@@ -414,9 +414,21 @@ Or in yaml:
 
     service_type: prometheus
     placement:
-      all_hosts: true
+      host_pattern: "myhost[1-3]"
 
+To place a service on *all* hosts, use ``"*"``::
 
+    orch apply crash '*'
+
+Or in yaml:
+
+.. code-block:: yaml
+
+    service_type: node-exporter
+    placement:
+      host_pattern: "*"
+
+    
 Setting a limit
 ---------------