Move examples and params to puppet strings style docs

[wyardley]

This is a first pass at moving docs to puppet-strings, starting with params and examples. Only bad thing is that we might want to move some of the params that aren't os specific back to init.pp at some point, so that it's easier to see default params in the docs.

[wyardley]

Let's also wait to merge this until some of the other changes are merged, don't want to create nasty rebase hell. Other than that, though, I think this should be pretty safe.

[HAIL9000]

Aw shoot sorry, I just saw this PR I will make sure to look it over this week!

[wyardley]

@HAIL9000 thanks! Ping me on Slack or IRC sometime if you want to discuss more (and I'll try to rebase as well). I think the big question is where the examples should go... I'm leaning towards that they should go in the types / providers they correspond with, but then I'm worried that they'll get buried unless there's some tooling to generate a README.

[wyardley]

One other thing I noticed -- moving examples out of README doesn't let us do:

 ```puppet

as best I can tell. Is there a way (in puppet strings) to set the code type?

[wyardley]

Rebased

[wyardley]

@HAIL9000 how's this?

As discussed on IRC, moved the examples for types back to the corresponding types, and left most of those examples in the README as well.

I'm getting some warnings (maybe related to https://tickets.puppetlabs.com/browse/PDOC-126 )

[warn]: In file `manifests/init.pp':0: Cannot resolve link to foo, from text:
	...{foo, baz}...
[warn]: In file `lib/puppet/type/rabbitmq_queue.rb':1: Cannot resolve link to x-message-ttl from text:
	...{x-message-ttl => 60, x-expires => 10}...
[warn]: In file `lib/puppet/type/rabbitmq_erlang_cookie.rb':6: Cannot resolve link to rabbitmq_home from text:
	...{rabbitmq_home}...
[warn]: In file `lib/puppet/type/rabbitmq_erlang_cookie.rb':6: Cannot resolve link to rabbitmq_home from text:
	...{rabbitmq_home}...

Is there a fix in terms of quoting that will fix this? Quoting the heredoc didn't make a difference.

Still some missing docs for parameters / etc., but can fix this iteratively.