Improve passing target type example

[xenoterracide]

Use case

After reading https://mapstruct.org/documentation/stable/reference/html/#passing-target-type I found myself unable to get what I felt was a modified version of the example to ever generate a usage of the resolver. The example is hard to understand and uses of generic terms like Reference which I'm sure is a class in many frameworks makes it even harder. After further discussion I don't even understand the purpose of this particular feature. To me it feels like a solution in want of a problem given other features. I'm certain I'm wrong, but from the documentation I can't tell why. The code in the example is also insufficient to actually reproduce the behavior that is generated.

Please improve the example and the use case for the example in the documentation.

More context can be found in, but the request was considered too opaque to understand. #3476

Generated Code

.

Possible workarounds

.

MapStruct Version

1.5.5