diff --git a/src/modules/packagechooserq/packagechooserq.conf b/src/modules/packagechooserq/packagechooserq.conf
index fc45e4fa9..ecf9ed1a6 100644
--- a/src/modules/packagechooserq/packagechooserq.conf
+++ b/src/modules/packagechooserq/packagechooserq.conf
@@ -6,9 +6,7 @@
 # Software selection mode, to set whether the software packages
 # can be chosen singly, or multiply.
 #
-# Possible modes are "optional", "required" (for zero-or-one or exactly-one)
-# or "optionalmultiple", "requiredmultiple" (for zero-or-more
-# or one-or-more).
+# The example QML module does not use a model, and ignores this value.
 mode: required
 
 # Software installation method:
@@ -40,7 +38,11 @@ mode: required
 # modules, either *contextualprocess* or *packages* or some custom
 # module, in the `exec` section to do the actual work.
 method: legacy
-# The *id* key is used only in "legacy" mode
+
+# The *id* key is used only in "legacy" mode and changes the GlobalStorage
+# key used to store the package choices. It is not recommended to use
+# this, since the module instance key does the same job.
+#
 # id: ""
 
 # The *pkgc* is used for setting the default selection in the QML view