Lots of updates to the documentation

Updated and reformatted the documentation to follow more closly the
Puppet Labs documentation guide
https://docs.puppetlabs.com/puppet/latest/reference/modules_documentation.html

Updat travis.yml to meet nokogiri dependency for ruby 1.8.7

Update to .travis if/then

Added debug

Exposed package version parameter to splunk class

Exposed the splunk::version parameter for use in upgrading splunk
Added additional docs to init.pp

Updated Rakefile to match requirements for "Approved"

Updated the Rakefile to follow the specs laid out here
https://forge.puppetlabs.com/approved/criteria

Changed index and forward to a bool

Cleaned up strings that should have been bools

Added some verbose warning if strings get passed in when they should be
bools.

Trying to get travis to run for ruby 1.8.7

Keep running into a nokogiri install dependcy which is breaking the build

Revert "Trying to get travis to run for ruby 1.8.7"

This reverts commit 70cc551cba88a180e1281059aa98019085d07477.
A good idea, but it didn't work :frown:

Flattery being the best for ... taken from puppetlabs/apache

Added more versions of Puppet to the test matrix

Cause.. you know longer builds are cool?

Upgraded Module to v1.6.0

This release should close huit/splunk#49 as well as make the module
closer to the new Puppet Labs standards for a approved module