Moved example manifests into Markdown

I think there are good reasons not to have the examples as real .pp manifests:

* My puppet doc command tries to read them :(
* Puppet lint complains about them
* We have to add the class bmclib::exampleuser to match the file name, but they are not really real

Having examples in markdown has good precedent
https://github.com/puppetlabs/puppetlabs-vcsrepo/blob/master/README.GIT.markdown

And being in markdown will allow us to annotate it easier, and users can see them from the webbrowser with syntax highlighting, etc.