docs-bug(coercion): Add a statement on how these functions relate to the Angular@^16 input transformers

[mwaibel-go]

Documentation Feedback

#18840 suggested input decorators for input coercion. It seems like they have finally landed in v16 in the form of the transform property on the Input() decorator. It looks like CDK’s coerceBooleanProperty and Angular’s booleanAttribute even are the same function, albeit worded differently.

I would appreciate a documentation update either here in the coercion section or in the “base” Angular docs regarding the two approaches to coercion: Is one in some way superior to the other? Will CDK’s version get deprecated? Can/should code safely be upgraded from CDK conversion to ‘native’?

Affected documentation page

https://material.angular.io/cdk/coercion/overview

[wagnermaciel]

Assigning to @crisbeto since he would have the most context on using the transform property (based on his work in PR #27704)