Address YARD warnings.

See lsegal/yard#746 for discussion.
Make `space` private.
Improve docs for monkey patched methods.

They were listed as being methods on `RSpec::Mocks`.
By defining the docs within `BasicObject`
and `Class` they are rendered properly.
Merge pull request #622 from rspec/address-yard-warnings

Address YARD warnings.