Deprecate package

Users should migrate to PHP 8 attributes.
doctrine · Oct 4, 2022 · 3989f06 · 3989f06
1 parent 516c188
commit 3989f06
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 0 deletions.
diff --git 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
@@ -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
@@ -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
 ============