Add documentation for `permit` matcher.
Standardize `failure_message` method naming