diff --git a/manifests/dashboard.pp b/manifests/dashboard.pp
index e943c8c2..41380459 100644
--- a/manifests/dashboard.pp
+++ b/manifests/dashboard.pp
@@ -28,8 +28,8 @@
 #
 # == Example:
 #
-# This will install the correct heat-dashboard package for your deployment.
-# horizon::dashboard { 'heat': }
+# This will install the correct cloudkitty-dashboard package for your deployment.
+# horizon::dashboard { 'cloudkitty': }
 #
 define horizon::dashboard (
   $ensure = 'present',
@@ -37,6 +37,11 @@ define horizon::dashboard (
 
   $dashboard = downcase($name)
 
+  if $dashboard in ['heat', 'octavia', 'manila'] {
+    warning("Use the horizon::dashboard::${dashboard} class instead. \
+The class allows more flexible customization of the ${dashboard} dashboard.")
+  }
+
   case $::osfamily {
     'Debian': {
       $dashboard_package_name = "python3-${dashboard}-dashboard"