--- a/modules/apache/manifests/vhosts.pp	Sat Jan 04 11:42:45 2020 +0000
+++ b/modules/apache/manifests/vhosts.pp	Sun Jan 26 11:36:07 2020 +0000
@@ -1,3 +1,23 @@
+# @summary
+#   Creates `apache::vhost` defined types.
+# 
+# @note See the `apache::vhost` defined type's reference for a list of all virtual 
+# host parameters or Configuring virtual hosts in the README section.
+#
+# @example To create a [name-based virtual host](https://httpd.apache.org/docs/current/vhosts/name-based.html) `custom_vhost_1`
+#   class { 'apache::vhosts':
+#     vhosts => {
+#       'custom_vhost_1' => {
+#         'docroot' => '/var/www/custom_vhost_1',
+#         'port'    => '81',
+#       },
+#     },
+#   }
+#
+# @param vhosts
+#   A hash, where the key represents the name and the value represents a hash of 
+#   `apache::vhost` defined type's parameters.
+#
 class apache::vhosts (
   $vhosts = {},
 ) {