The documentations of deprecated APIs mostly do not have the suggested new API in the front page. For instance, the commonly used
tf.keras.preprocessing.text.tokenizer is deprecated as of TF 2.8 but it does not mention the suggested alternatives.
I searched through and figure probably the
tf.keras.layers.TextVectorization is suggested? This is just one of the examples and there are tons of examples like this in the TF doc to be improved.
In the doc of deprecated APIs, suggest adding the link of alternatives so that users can quickly get to know how to update the code to adapt to the latest release of TensorFlow.