Documentation update: private constants, readme

* make private constants private so they disappear from YARD
* add README.md to gemspec files list