clarifies documentation, fixes typos in gemspec files
fixes description in gemspec
updates readme