diff --git a/test/yaml_hosts b/test/yaml_hosts
index 3856db00938..adfcf5bce51 100644
--- a/test/yaml_hosts
+++ b/test/yaml_hosts
@@ -1,5 +1,7 @@
 ---
 
+# Below is the original way of defining hosts and groups.
+
 - jupiter
 - host: saturn
   vars:
@@ -38,6 +40,12 @@
   hosts:
   - saturn
 
+# Here we demonstrate that groups can be defined on a per-host basis.
+# When managing a large set of systems this format makes it easier to
+# ensure each of the systems is defined in a set of groups, compared
+# to the standard group definitions, where a host may need to be added
+# to multiple disconnected groups.
+
 - host: garfield
   groups: [ comic, cat, orange ]
   vars: