match mocks to expectations/core and not exclude yard
`@api private` had no effect here so lets make them `@private`
Merge pull request #638 from rspec/fix_docs

Match mocks to expectations/core and not exclude yard from Travis