Improve formatting of code example

* Puppet syntax highlighting
* Double-spaced indentation
* Aligned instances of =>
* Quoted strings
* Single-quoted some unnecessarily double-quoted strings
* Removed comma from the last variable
Merge pull request #110 from 3flex/patch-1

Improve formatting of README code example
Rewrite the docs to fit the current best practices for Puppetlabs
modules.
Cleaning up linting error with ensure param
Merge pull request #115 from hundredacres/master

Cleaning up linting issues
add system tests for file fragments sourced from a single file

In addition to checking for fragment sourcing from a 'list' of files.
fix regression preventing usage of fragment ensure => /target syntax

Also fix a historical bug that prevents a fragment from being converted
from a symlink to using a source or content parameter.
Merge pull request #117 from jhoblitt/fragment_source

 fix regression preventing usage of fragment ensure => /target syntax
revert concat $warn/$warn_message param split + add deprecation warnings

Partially reverting the $warn/$warn_message param split from eaf8407 as this
change was unnecessarily API breaking.  Instead, we are adding string/bool type
validating to the $warn parameter and deprecation warnings for the usage of
stringified boolean values (eg, 'true', 'on', etc.). In a future major release,
the logic can be simplified to treating all string values as a warning message.
Merge pull request #124 from jhoblitt/revert_warn_message

revert concat $warn/$warn_message param split + add deprecation warnings
add README section on API deprecations since version 1.0.0
Merge pull request #1 from jhoblitt/docs-change

add README section on API deprecations since version 1.0.0
Merge pull request #114 from apenney/docs-change

Rewrite the docs to fit the current best practices for Puppetlabs
work around RubyGems 2.2.0 breaking ruby 1.8.7
Merge pull request #126 from jhoblitt/rubygems_220_travis_workaround

work around RubyGems 2.2.0 breaking ruby 1.8.7
1.1.0 release.
Add information on deprecations.
Merge pull request #125 from apenney/200-release

1.1.0 release.
remove workaround for Rubygems 2.2.0 bug

https://github.com/rubygems/rubygems/pull/763 is merged and released in
Rubygems 2.2.1. A forced downgrade is no longer required.
Merge pull request #127 from 3flex/remove-rubygems-2.2.0-workaround

remove workaround for Rubygems 2.2.0 bug