added documentation for the text-decoration-control component

[BenjaminZekavica]

What?

Added documentation for the text-decoration control.

Why?

#52071

[aaronrobertshaw]

Thanks for the continued efforts to improve documentation @BenjaminZekavica 👍

TextDecorationControl and TextTransformControl (readme added in #52243) are actually experimental components. I was under the impression these shouldn't have documentation until they are stabilized.

An alternative to waiting on that stabilization might be to flag the components as experimental in the readme docs similar to how it is done in the @wordpress/components package by prefixing the following.

<div class="callout callout-alert">
This feature is still experimental. “Experimental” means this is an early implementation subject to drastic and breaking changes.
</div>
<br />

This also highlights an error in the usage information as the import statement is incorrect.

I've left a few other tweaks as inline suggestions.

[BenjaminZekavica]

@aaronrobertshaw Thank you :) I updated the readme, do you can check it please?

[aaronrobertshaw]

Thanks for continuing to iterate on this @BenjaminZekavica 🙇

I think this PR is nearly ready. I've left a couple of further tweaks as inline suggestions we should probably address before merging.

[BenjaminZekavica]

@aaronrobertshaw I accepted your changes now :) I think it's ready to merge 👍

[aaronrobertshaw]

LGTM 🚢

[aaronrobertshaw]

It appears there's a failing e2e due to a timeout. I've hit re-run on that job. Once everything passes we can look to merge.