| Subject: | documentation on coerce methods needs more details |
The following applies to:
https://metacpan.org/pod/Type::Tiny#Validation-and-coercion
The coerce method should mention that coercion on nesting types like Dict is likely to discard all individual coercion results if any of the member types of the nesting type fail their type check after their individual coercion; and the original value is returned unchanged.
The assert_coerce method should state instead of "Throws an exception if this is not possible." (which can be read as it returning some kind of introspection on the coercion process itself), that it "Runs C<assert_valid> after the coercion to verify success.".