Amend assert documentation to match code.

Surfaced in https://github.com/rspec/rspec-core/issues/1354