diff --git a/etc/kayobe/kolla.yml b/etc/kayobe/kolla.yml
index 1a3e29e..0619145 100644
--- a/etc/kayobe/kolla.yml
+++ b/etc/kayobe/kolla.yml
@@ -79,7 +79,7 @@
 # kolla_install_type=source. See kolla.common.config for details.
 # Example:
 # kolla_sources:
-#   ironic_base:
+#   ironic-base:
 #     type: git
 #     location: https://github.com/openstack/ironic
 #     reference: master
@@ -145,6 +145,7 @@
 #kolla_openstack_logging_debug:
 
 # Upper constraints file for installation of Kolla.
+# Default value is {{ pip_upper_constraints_file }}.
 #kolla_upper_constraints_file:
 
 # User account to use for Kolla SSH access.
diff --git a/etc/kayobe/pip.yml b/etc/kayobe/pip.yml
index 29a84f0..93fcbca 100644
--- a/etc/kayobe/pip.yml
+++ b/etc/kayobe/pip.yml
@@ -1,5 +1,10 @@
 ---
 
+# Upper constraints file for installation of python packages.
+# Default value is
+# "https://releases.openstack.org/constraints/upper/queens"
+#pip_upper_constraints_file:
+
 # Use a local PyPi mirror for installing Pip packages
 #pip_local_mirror: false