Documentation improvements

- Add puppet-doc-lint project to ensure we have correct documentation
- Update init file to have all the variables documentend
- Update spec files due to certain changes
Merge pull request #100 from elasticsearch/doc_improvements

Documentation improvements