-# The optional hints field is a list of YAML references to hints
-# that may be available at this location. (This is why locations
-# has to follow hints.) The "sound" attribute, if present, is s
-# label for a location sound. If there is a "loud" attribute and
-# it is true, object sounds are drowned out at this location.
+# hints: A list of YAML references to hints that may be available at
+# this location. (This is why locations has to follow hints.)
+# sound: Label for a location sound.
+# loud: If true, object sounds are drowned out at this location.
+#
+# All attributes are optional except the long description. Order of
+# locations is not significant.