Documenting minion-specific etcd ext_pillar

salt/pillar/etcd_pillar.py

@@ -33,6 +33,30 @@ Using these configuration profiles, multiple etcd sources may also be used:
     ext_pillar:
       - etcd: my_etcd_config
       - etcd: my_other_etcd_config
+
+If you would like to have minion-specific information in etcd, you may use the
+``minion_id`` in the ``root`` value:
+
+.. code-block:: yaml
+
+    ext_pillar:
+      - etcd: my_etcd_config root=/salt/%(minion_id)s
+
+Minion-specific values may override shared values when the minion-specific root
+appears after the shared root:
+
+.. code-block:: yaml
+
+    ext_pillar:
+      - etcd: my_etcd_config root=/salt-shared
+      - etcd: my_other_etcd_config root=/salt-private/%(minion_id)s
+
+For example, if you wanted to share a key with all minions but override its
+value for a specific minion, you could do something like this with etcd::
+
+    etcdctl set /salt-shared/mykey my_value
+    etcdctl set /salt-private/special_minion_id/mykey my_other_value
+
 '''
 
 # Import python libs