Prepare repository for a Puppet Forge release

  Commit updates README.md with a consistent template for documentation,
  removes travis.yml since we're on stackfoge now, updates the
  Modulefile for release, removes CHANGELOG in favor of summarized release
  notes in the README that will be viewable on Forge for the new
  release, and moves examples to tests to adhere to Puppet Labs Style
  Guide (http://docs.puppetlabs.com/guides/style_guide.html#tests).

Change-Id: If61952790ce1228561e984ca1664dd14aba0c6ff
Merge "Prepare repository for a Puppet Forge release"
Adds upgrade warning for token_format.

  This commit will add a warning under the Limitations section to inform
  people of the change from UUID to PKI as the default token format.

Change-Id: I086215a256cf82f45e9793bb157a0cf5c59ac3d0
Various Puppet lint fixes

* Fixes following warnings:
    * indentation of => is not properly aligned
    * string containing only a variable
* Fixes following errors:
    * tab character found
    * two-space soft tabs not used
* Remove quotes around class in include/require statements

Change-Id: I7e17d9153d413792e32f9d7c430dfbd37852ba51
Remove unused template

Template was used by keystone::client::authtoken which is now gone.

Change-Id: I5bd7b5aa132686cc5b4b622bdc0d9763f0258a4b
Merge "Various Puppet lint fixes"
Ensure 'id' is included by keystone_tenant.instances.

 * Previously keystone_tenant was only including the 'name' field
   in the results of instances().  This patch includes the 'id'
   field to allow discovery of id from the name.

Change-Id: Ibd5b22f6b29bc0f07e5c3c1cd52a404d32ea0b89
Improve tenant_hash usage in keystone_tenant.

 * The tenant_hash used by the keystone_tenant type to keep track
   of tenants is now updated with new tenants as they are created.
 * Added 'instance' helper method that returns
   tenant_hash[resource[:name]]
 * Added spec tests for the changes.

Change-Id: I077e5012a3f2d20d3df4cc55f1150490d4b31f58