Update gemspec description.
Rewrite YARD docs in terms of `expect` rather than `should`.
Correct docs.