RUBY-636 Documentation and specs tweaks after PR review