diff --git a/README.rst b/README.rst
index 7db2dc6d9..b9f234807 100644
--- a/README.rst
+++ b/README.rst
@@ -1,9 +1,10 @@
-ceph-ansible is deprecated, please migrate to ``cephadm`` instead.
-==================================================================
+Ceph Ansible
+==============
 
+    The project is still maintained for the time being but it is encouraged to migrate to `cephadm <https://docs.ceph.com/en/latest/cephadm/>`_.
 
-``cephadm`` is the new official Ceph installer.
+Ansible playbooks for Ceph, the distributed object, block, and file storage platform.
 
-See ``cephadm`` documentation [1]
-
-[1] https://docs.ceph.com/en/latest/cephadm/
+Please refer to our hosted documentation here: https://docs.ceph.com/projects/ceph-ansible/en/latest/
+You can view documentation for our ``stable-*`` branches by substituting ``main`` in the link
+above for the name of the branch. For example: https://docs.ceph.com/projects/ceph-ansible/en/stable-8.0/