docs: improve deprecation notice