[Feature request]: Provide additional information for deprecation note

Deprecation notes say what is deprecated but not what to use instead. Would be great to have more information for what should be used instead of the deprecated API.

Thanks for your work!