diff --git a/doc/reference/annotations.rst b/doc/reference/annotations.rst
index 765deaf5f..bdb342595 100644
--- a/doc/reference/annotations.rst
+++ b/doc/reference/annotations.rst
@@ -1,6 +1,11 @@
 Attributes and annotations
 ==========================
 
+.. warning::
+Starting from release 3.30.0 [doctrine/annotations](https://github.com/doctrine/annotations) is an optional package. 
+If you still want to use them, please make sure that you require in `composer.json` file.
+
+
 PHP 8 support
 ~~~~~~~~~~~~~~~
 JMS serializer now supports PHP 8 attributes, with a few caveats: