diff --git a/manifests/db/mysql.pp b/manifests/db/mysql.pp
index 9a69963e..7dfd9684 100644
--- a/manifests/db/mysql.pp
+++ b/manifests/db/mysql.pp
@@ -6,27 +6,31 @@
 # === Parameters
 #
 # [*password*]
-#   password to connect to the database. Mandatory.
+#   (Required) password to connect to the database.
 #
 # [*dbname*]
-#   name of the database. Optional. Defaults to cinder.
+#   (Optional) name of the database.
+#   Defaults to 'cinder'.
 #
 # [*user*]
-#   user to connect to the database. Optional. Defaults to cinder.
+#   (Optional) user to connect to the database.
+#   Defaults to 'cinder'.
 #
 # [*host*]
-#   the default source host user is allowed to connect from.
-#   Optional. Defaults to 'localhost'
+#   (Optional) the default source host user is allowed to connect from.
+#   Defaults to 'localhost'
 #
 # [*allowed_hosts*]
-#   other hosts the user is allowed to connect from.
-#   Optional. Defaults to undef.
+#   (Optional) other hosts the user is allowed to connect from.
+#   Defaults to undef.
 #
 # [*charset*]
-#   the database charset. Optional. Defaults to 'utf8'
+#   (Optional) the database charset.
+#   Defaults to 'utf8'
 #
 # [*collate*]
-#   the database collation. Optional. Defaults to 'utf8_general_ci'
+#   (Optional) the database collation.
+#   Defaults to 'utf8_general_ci'
 #
 class cinder::db::mysql (
   $password,