remove API documentation from .pp files

Refer to the README for all parameter documentation.

README.md

@@ -68,7 +68,10 @@ class { '::mdadm':
 
 ##### `force_service`
 
-`Bool`  defaults to 'false'
+`Bool`  defaults to `false`
+
+By default, the `mdadm` class will not attempt to start the `mdmonitor` service
+unless the `$::mdadm_arrays` fact lists `md` arrays.  If this parameter is set to `true` the class will always attempt to start the `mdmonitor` service.
 
 ##### `service_ensure`
 

manifests/init.pp

@@ -1,30 +1,7 @@
 # == Class: mdadm
 #
-# simple template
-#
-# === Parameters
-#
-# All parameteres are optional.
-#
-# [*config_options*]
-#   Hash.  defaults to '{}'
-#
-# [*force_service*]
-#   Bool.  defaults to 'false'
-#
-# [*service_ensure*]
-#   String.  defaults to 'running'
-#   Valid strings are: 'running', 'stopped'
-#
-# [*service_enable*]
-#   Bool.  defaults to 'true'
-#
-# [*raid_check_options*]
-#   Hash.  defaults to '{}'
-#
-# === Examples
-#
-# include mdadm
+# Please refer to https://github.com/jhoblitt/puppet-mdadm#usage for parameter
+# documentation.
 #
 class mdadm(
   $config_options     = {},

manifests/params.pp

@@ -2,14 +2,6 @@
 #
 # This class should be considered private.
 #
-# === Authors
-#
-# Joshua Hoblitt <jhoblitt@cpan.org>
-#
-# === Copyright
-#
-# Copyright (C) 2013 Joshua Hoblitt
-#
 class mdadm::params {
   case $::osfamily {
     'redhat': {