diff --git a/README.md b/README.md
index c2c7eb7ba..0b350aa1c 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,7 @@
+⚠️ PHP 8 introduced [attributes](https://www.php.net/manual/en/language.attributes.overview.php),
+which are a native replacement for annotations. As such, this library is
+deprecated, and should receive exclusively bugfixes and security fixes.
+
 # Doctrine Annotations
 
 [![Build Status](https://github.com/doctrine/annotations/workflows/Continuous%20Integration/badge.svg?label=build)](https://github.com/doctrine/persistence/actions)
diff --git a/composer.json b/composer.json
index 62f76d217..b5839c84a 100644
--- a/composer.json
+++ b/composer.json
@@ -45,6 +45,9 @@
         "symfony/cache": "^4.4 || ^5.4 || ^6",
         "vimeo/psalm": "^4.10"
     },
+    "suggest": {
+        "php": "PHP 8.0 or higher comes with attributes, a native replacement for annotations"
+    },
     "autoload": {
         "psr-4": {
             "Doctrine\\Common\\Annotations\\": "lib/Doctrine/Common/Annotations"
diff --git a/docs/en/index.rst b/docs/en/index.rst
index 95476c313..aef126579 100644
--- a/docs/en/index.rst
+++ b/docs/en/index.rst
@@ -1,3 +1,11 @@
+Deprecation notice
+==================
+
+PHP 8 introduced `attributes
+<https://www.php.net/manual/en/language.attributes.overview.php>`_,
+which are a native replacement for annotations. As such, this library is
+deprecated, and should receive exclusively bugfixes and security fixes.
+
 Introduction
 ============