Document supports_block_expectations for the custom matcher DSL

An attempt to expand our documentation to resolve #638