diff --git a/manifests/compute/scheduler.pp b/manifests/compute/scheduler.pp
index 390623aa..7ec4e72e 100644
--- a/manifests/compute/scheduler.pp
+++ b/manifests/compute/scheduler.pp
@@ -13,8 +13,12 @@
 # License for the specific language governing permissions and limitations
 # under the License.
 #
+# == Class: cloud::compute::scheduler
+#
 # Compute Scheduler node
 #
+# === Parameters:
+#
 # [*scheduler_default_filters*]
 #   (optional) A comma separated list of filters to be used by default
 #   Defaults to false
diff --git a/manifests/dashboard.pp b/manifests/dashboard.pp
index 0d2f42f1..581c9425 100644
--- a/manifests/dashboard.pp
+++ b/manifests/dashboard.pp
@@ -51,19 +51,19 @@
 #
 # [*keystone_proto*]
 #   (optional) Protocol (http or https) of keystone endpoint.
-#   Defaults to 'http'
+#   Defaults to 'http'
 #
 # [*keystone_host*]
 #   (optional) IP / Host of keystone endpoint.
-#   Defaults '127.0.0.1'
+#   Defaults '127.0.0.1'
 #
 # [*keystone_port*]
 #   (optional) TCP port of keystone endpoint.
-#   Defaults to '5000'
+#   Defaults to '5000'
 #
 # [*debug*]
 #   (optional) Enable debug or not.
-#   Defaults to true
+#   Defaults to true
 #
 # [*horizon_cert*]
 #   (required with listen_ssl) Certificate to use for SSL support.
diff --git a/manifests/init.pp b/manifests/init.pp
index 945665de..576dc4bb 100644
--- a/manifests/init.pp
+++ b/manifests/init.pp
@@ -19,27 +19,27 @@
 #
 # === Parameters:
 #
-#  [*rhn_registration*]
-#   (optional) The RedHat network authentication token
-#   Defaults to undef
+# [*rhn_registration*]
+#  (optional) The RedHat network authentication token
+#  Defaults to undef
 #
-#  [*root_password*]
-#   (optional) Unix root password
-#   Defaults to 'root'
+# [*root_password*]
+#  (optional) Unix root password
+#  Defaults to 'root'
 #
-#  [*dns_ips*]
-#   (optional) Hostname or IP of the Domain Name Server (dns) used
-#   Should by an array.
-#   Defaults to google public dns ['8.8.8.8', '8.8.4.4']
+# [*dns_ips*]
+#  (optional) Hostname or IP of the Domain Name Server (dns) used
+#  Should by an array.
+#  Defaults to google public dns ['8.8.8.8', '8.8.4.4']
 #
-#  [*site_domain*]
-#   (optional) Domain name (used for search and domain fields
-#   of resolv.conf configuration file
-#   Defaults to 'mydomain'
+# [*site_domain*]
+#  (optional) Domain name (used for search and domain fields
+#  of resolv.conf configuration file
+#  Defaults to 'mydomain'
 #
-#  [*motd_title*]
-#   (optional) A string used in the top of the server's motd
-#   Defaults to 'eNovance IT Operations'
+# [*motd_title*]
+#  (optional) A string used in the top of the server's motd
+#  Defaults to 'eNovance IT Operations'
 #
 # [*selinux_mode*]
 #   (optional) SELinux mode the system should be in
diff --git a/manifests/loadbalancer/binding.pp b/manifests/loadbalancer/binding.pp
index 5fb957f1..c3b0ca84 100644
--- a/manifests/loadbalancer/binding.pp
+++ b/manifests/loadbalancer/binding.pp
@@ -14,6 +14,9 @@
 # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 # License for the specific language governing permissions and limitations
 # under the License.
+#
+# == Define: cloud::loadbalancer::binding
+#
 define cloud::loadbalancer::binding (
   $ip,
   $port,
diff --git a/manifests/network/metadata.pp b/manifests/network/metadata.pp
index 929f9b37..2ca0a155 100644
--- a/manifests/network/metadata.pp
+++ b/manifests/network/metadata.pp
@@ -13,6 +13,8 @@
 # License for the specific language governing permissions and limitations
 # under the License.
 #
+# == Class: cloud::network::metadata
+#
 # Network Metadata node (need to be run once)
 # Could be managed by spof_node manifest
 #