See [rspec-core on staging](http://rspec-staging.github.io/documentation/3/rspec-core/) for example:  The 3.8 docs for mocks and expectations are slightly messed up, too, but the rails docs are kinda messed up. @JonRowe any ideas?