Deprecated ReplicationController in 5.1 -kubernetes-internals -fix ?!

[KareimGazer]

It's mentioned in the Controllers part that

When you declare X replicas of a Pod in your deployment.yaml, a controller called Replication Controller makes sure that will be true. There are a number of controllers for different responsibilities.

However, Kubernetes documentation mentions that:

ReplicationController is a Legacy API for managing workloads that can scale horizontally and A Deployment that configures a ReplicaSet is now the recommended way to set up replication.

Does it need a fix or it's for the sake of giving just some examples of controllers?
if so how about giving a better new and more applicable example or at least mentioning that's deprecated ?

Thanks,

[KareimGazer]

@matti @mluukkai