[ci skip] Change/add notes: THIS BRANCH IS OBSOLETE.
diff --git a/README.rst b/README.rst
index 54da634..757232e 100644
--- a/README.rst
+++ b/README.rst
@@ -13,10 +13,25 @@
.. start
-.. Note::
+NOTE
+----
- This is the pybind11 **smart_holder** branch. Please refer to
- ``README_smart_holder.rst`` for branch-specific information.
+**THIS BRANCH IS OBSOLETE.** — It was merged into the pybind11 master branch
+with `PR #5542 <https://github.com/pybind/pybind11/pull/5542>`_.
+
+Please switch to pybind11 master or future pybind11 releases.
+
+You will need to remove ``#include <pybind11/smart_holder.h>``
+from your code, and these obsolete macros:
+
+* ``PYBIND11_TYPE_CASTER_BASE_HOLDER``
+* ``PYBIND11_SMART_HOLDER_TYPE_CASTERS``
+* ``PYBIND11_SH_AVL``
+* ``PYBIND11_SH_DEF``
+
+
+Overview
+--------
**pybind11** is a lightweight header-only library that exposes C++ types
in Python and vice versa, mainly to create Python bindings of existing
diff --git a/README_smart_holder.rst b/README_smart_holder.rst
index 05b1ab5..1809a70 100644
--- a/README_smart_holder.rst
+++ b/README_smart_holder.rst
@@ -2,6 +2,21 @@
pybind11 — smart_holder branch
==============================
+NOTE
+====
+
+**THIS BRANCH IS OBSOLETE.** — It was merged into the pybind11 master branch
+with `PR #5542 <https://github.com/pybind/pybind11/pull/5542>`_.
+
+Please switch to pybind11 master or future pybind11 releases.
+
+You will need to remove ``#include <pybind11/smart_holder.h>``
+from your code, and these obsolete macros:
+
+* ``PYBIND11_TYPE_CASTER_BASE_HOLDER``
+* ``PYBIND11_SMART_HOLDER_TYPE_CASTERS``
+* ``PYBIND11_SH_AVL``
+* ``PYBIND11_SH_DEF``
Overview
========
