add fields to gemspec
touch up some documentation for yard