Update the best practices guide

### Description

The migration best practices section is misleading users by suggesting that some mediators are deprecated. However, these mediators will continue to work in future versions as well, and there is no plan to remove them. The section needs to be updated to clarify this.

### Version

_No response_