Could I be picky and request that you include something about should here rather than at the bottom? e.g:

    Each matcher can be used with `expect(..).to` or `expect(..).not_to` to define positive and
    negative expectations respectively on an object. Most matchers can also be accessed using
    the `(...).should` and `(...).should_not` syntax, see [using should syntax](https://github.com/rspec/rspec-rails/blob/master/Should.md) 
    for why we recommend using `expect`.