Update docs to reflect deprecated annotations (#2823)

* Update docs to reflect deprecated annotations

* Update CHANGELOG.md

Co-authored-by: Javier Spagnoletti <[email protected]>

---------

Co-authored-by: Javier Spagnoletti <[email protected]>

Author: franmomu

CHANGELOG.md

@@ -20,20 +20,20 @@ a release.
 ## [Unreleased]
 
 ## [3.16.0]
-### Deprecated
-- Support for `doctrine/annotations` has been deprecated and will be removed in 4.0. 
-
-### Fixed
-- Tree: Cascade remove not being triggered on entity children at `MaterializedPath::removeNode()`.
-- Tree: Materialize Path strategy when using autogenerated identifiers.
-
 ### Added
+- Support for `doctrine/orm` 3
 - Blameable: Added UUID in allowed types list for Blameable fields in Annotation
 - Blameable: Allow ascii_string to validTypes (issue #2726)
 - Sluggable: Allow ascii_string to validTypes
 - IpTraceable: Allow ascii_string to validTypes
 - Sluggable: Use `TranslationWalker` hint when looking for similar slugs (`getSimilarSlugs` method) for entities which implement `Translatable` interface and have `uniqueOverTranslations: true` Slug option (#100, #2530)
-- Support for `doctrine/orm` 3.0
+
+### Deprecated
+- Support for defining mapping information from annotations has been deprecated and will be removed in 4.0, use PHP attributes mapping instead.
+
+### Fixed
+- Tree: Cascade remove not being triggered on entity children at `MaterializedPath::removeNode()`.
+- Tree: Materialize Path strategy when using autogenerated identifiers.
 
 ## [3.15.0]
 ### Added

README.md

@@ -61,7 +61,7 @@ flushed in a behavioral way.
 - [**References**](/doc/references.md) - supports linking Entities in Documents and vice versa
 - [**ReferenceIntegrity**](/doc/reference_integrity.md) - constrains ODM MongoDB Document references
 
-All extensions support **Attribute**, **Annotation** and **XML** mapping. Additional mapping drivers
+All extensions support **Attribute**, **XML** and **Annotation** (deprecated) mapping. Additional mapping drivers
 can be easily implemented using Mapping extension to handle the additional metadata mapping.
 
 ### Version Compatibility