@myronmarston np for the doc strings.

about the fail examples:
https://github.com/rspec/rspec-expectations/pull/505/files#diff-de7b4e8d8bcfeb8d8d6c90c3db9bda24R29

isn't this sufficient? what did you had in mind?