diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5f1a002d3..70dc95021 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,21 @@
 # CHANGELOG
 
+## 4.32.3
+
+* Deprecated `Nelmio\ApiDocBundle\Annotation` namespace in favor of `Nelmio\ApiDocBundle\Attribute` namespace in preparation for 5.x. Consider upgrading to the new attribute syntax.
+```diff 
+- use Nelmio\ApiDocBundle\Annotation\Areas;
+- use Nelmio\ApiDocBundle\Annotation\Model;
+- use Nelmio\ApiDocBundle\Annotation\Operation;
+- use Nelmio\ApiDocBundle\Annotation\Security;
+
++ use Nelmio\ApiDocBundle\Attribute\Areas;
++ use Nelmio\ApiDocBundle\Attribute\Model;
++ use Nelmio\ApiDocBundle\Attribute\Operation;
++ use Nelmio\ApiDocBundle\Attribute\Security;
+```
+
+
 ## 4.32.0
 
 * Added support to configure `options` and `serializationContext` via `nelmio_api_doc.models.names`.
diff --git a/docs/alternative_names.rst b/docs/alternative_names.rst
index 6e1f4903d..90b1f7cd8 100644
--- a/docs/alternative_names.rst
+++ b/docs/alternative_names.rst
@@ -29,7 +29,7 @@ In this case the class ``App\Entity\User`` will be aliased into:
 
 .. tip::
 
-    This allows to use normal references instead of ``@Model``. Notably, you can specify
+    This allows to use normal references instead of ``#[Model]``. Notably, you can specify
     the groups used for a model once in config and then refer to its alternative name:
 
     .. code-block:: yaml
@@ -38,14 +38,26 @@ In this case the class ``App\Entity\User`` will be aliased into:
             models:
                 names: [ { alias: MyModel, type: App\MyModel, groups: [light] }]
 
-    .. code-block:: php
+    .. configuration-block::
 
-        class HomeController
-        {
-            /**
-             * @OA\Response(response=200, @OA\JsonContent(ref="#/components/schemas/MyModel"))
-             */
-            public function indexAction()
+        .. code-block:: php-annotations
+
+            class HomeController
             {
+                /**
+                 * @OA\Response(response=200, @OA\JsonContent(ref="#/components/schemas/MyModel"))
+                 */
+                public function indexAction()
+                {
+                }
             }
-        }
+
+        .. code-block:: php-attributes
+
+            class HomeController
+            {
+                #[OA\Response(response: 200, content: new OA\JsonContent(ref: "#/components/schemas/MyModel"))]
+                public function indexAction()
+                {
+                }
+            }
\ No newline at end of file
diff --git a/docs/areas.rst b/docs/areas.rst
index fa2705c8f..62511e4f9 100644
--- a/docs/areas.rst
+++ b/docs/areas.rst
@@ -62,12 +62,12 @@ Then update your routing to be able to access your different documentations:
 
 That's all! You can now access ``/api/doc/internal``, ``/api/doc/commercial`` and ``/api/doc/store``.
 
-Use annotations to filter documented routes in each area
+Use attributes to filter documented routes in each area
 --------------------------------------------------------
 
-You can use the `@Areas` annotation inside your controllers to define your routes' areas.
+You can use the ``#[Areas]`` attribute inside your controllers to define your routes' areas.
 
-First, you need to define which areas will use the`@Areas` annotations to filter
+First, you need to define which areas will use the`#[Areas]` attributes to filter
 the routes that should be documented:
 
 .. code-block:: yaml
@@ -79,20 +79,45 @@ the routes that should be documented:
             internal:
                 with_annotation: true
 
-Then add the annotation before your controller or action::
+Then add the attribute/annotation before your controller or action::
 
-    use Nelmio\Annotations as Nelmio;
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        use Nelmio\Annotation as Nelmio;
+
+        /**
+         * @Nelmio\Areas({"internal"}) => All actions in this controller are documented under the 'internal' area
+         */
+        class MyController
+        {
+            /**
+             * @Nelmio\Areas({"internal"}) => This action is documented under the 'internal' area
+             */
+            public function index()
+            {
+               ...
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        use Nelmio\Attribute as Nelmio;
 
-    /**
-     * @Nelmio\Areas({"internal"}) => All actions in this controller are documented under the 'internal' area
-     */
-    class MyController
-    {
         /**
-         * @Nelmio\Areas({"internal"}) => This action is documented under the 'internal' area
+         * All actions in this controller are documented under the 'internal' area
          */
-        public function index()
+        #[Nelmio\Areas(["internal"])]
+        class MyController
         {
-           ...
+            /**
+             * This action is documented under the 'internal' area
+             */
+            #[Nelmio\Areas(["internal"])]
+            public function index()
+            {
+               ...
+            }
         }
-    }
+
diff --git a/docs/faq.rst b/docs/faq.rst
index f3558634c..496eb03be 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -180,19 +180,33 @@ Endpoints grouping
 
 Q: Areas feature doesn't fit my needs. So how can I group similar endpoints of one or more controllers in a separate section in the documentation?
 
-A: Use ``@OA\Tag`` annotation.
+A: Use ``#[OA\Tag]`` attribute.
 
-.. code-block:: php
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        /**
+         * Class BookmarkController
+         *
+         * @OA\Tag(name="Bookmarks")
+         */
+        class BookmarkController extends AbstractFOSRestController implements ContextPresetInterface
+        {
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        /**
+         * Class BookmarkController
+         */
+        #[OA\Tag(name: "Bookmarks")]
+        class BookmarkController extends AbstractFOSRestController implements ContextPresetInterface
+        {
+            // ...
+        }
 
-    /**
-     * Class BookmarkController
-     *
-     * @OA\Tag(name="Bookmarks")
-     */
-    class BookmarkController extends AbstractFOSRestController implements ContextPresetInterface
-    {
-        // ...
-    }
 
 Disable Default Section
 -----------------------
@@ -214,23 +228,38 @@ Overriding a Form or Plain PHP Object Schema Type
 Q: I'd like to define a PHP object or form with a type other any ``object``, how
 do I do that?
 
-A: By using the ``@OA\Schema`` annotation or attribute with a ``type`` or ``ref``.
+A: By using the ``#[OA\Schema]`` attribute/annotation with a ``type`` or ``ref``.
 Note, however, that a ``type="object"`` will still read all a models properties.
 
-.. code-block:: php
-
-    <?php
-    use OpenApi\Annotations as OA;
-    use Nelmio\ApiDocBundle\Annotation\Model;
-
-    /**
-     * @OA\Schema(type="array", @OA\Items(ref=@Model(type=SomeEntity::class)))
-     *
-     * or define a `ref`:
-     * @OA\Schema(ref="#/components/schemas/SomeRef")
-     */
-    class SomeCollection implements \IteratorAggregate
-    {
-        // ...
-    }
-
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        use Nelmio\ApiDocBundle\Annotation\Model;
+        use OpenApi\Annotations as OA;
+
+        /**
+         * @OA\Schema(type="array", @OA\Items(ref=@Model(type=SomeEntity::class)))
+         *
+         * or define a `ref`:
+         * @OA\Schema(ref="#/components/schemas/SomeRef")
+         */
+        class SomeCollection implements \IteratorAggregate
+        {
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        use Nelmio\ApiDocBundle\Attribute\Model;
+        use OpenApi\Attributes as OA;
+
+        /**
+         * or define a `ref`:
+         * #[OA\Schema(ref: "#/components/schemas/SomeRef")
+         */
+        #[OA\Schema(type: "array", items: new OA\Items(ref: new Model(type: SomeEntity::class)))]
+        class SomeCollection implements \IteratorAggregate
+        {
+            // ...
+        }
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index eec3812ea..76203f2a4 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -105,7 +105,7 @@ How does this bundle work?
 --------------------------
 
 It generates an OpenAPI documentation from your Symfony app thanks to
-**Describers**. One extracts data from SwaggerPHP annotations, one from your
+**Describers**. One extracts data from SwaggerPHP attributes/annotations, one from your
 routes, etc.
 
 If you configured the ``app.swagger_ui`` route above, you can browse your
@@ -151,8 +151,8 @@ You can configure global information in the bundle configuration ``documentation
     This configuration field can more generally be used to store your documentation as yaml.
     You may find in the ``.yaml`` files from `SwaggerPHP examples`_.
 
-To document your routes, you can use the SwaggerPHP annotations and the
-``Nelmio\ApiDocBundle\Annotation\Model`` annotation in your controllers::
+To document your routes, you can use the SwaggerPHP attributes/annotations and the
+``#[Model]`` attribute/annotation in your controllers::
 
 .. configuration-block::
 
@@ -204,8 +204,8 @@ To document your routes, you can use the SwaggerPHP annotations and the
 
         use AppBundle\Entity\Reward;
         use AppBundle\Entity\User;
-        use Nelmio\ApiDocBundle\Annotation\Model;
-        use Nelmio\ApiDocBundle\Annotation\Security;
+        use Nelmio\ApiDocBundle\Attribute\Model;
+        use Nelmio\ApiDocBundle\Attribute\Security;
         use OpenApi\Attributes as OA;
         use Symfony\Component\Routing\Annotation\Route;
 
@@ -244,7 +244,7 @@ The normal PHPDoc block on the controller method is used for the summary and des
 
 .. tip::
 
-    Examples of using the annotations can be found in `SwaggerPHP examples`_.
+    Examples of using the attributes/annotations can be found in `SwaggerPHP examples`_.
     However, unlike in those examples, when using this bundle you don't need to specify paths and you can easily document models as well as some
     other properties described below as they can be automatically be documented using the Symfony integration.
 
@@ -257,14 +257,14 @@ The normal PHPDoc block on the controller method is used for the summary and des
 Use Models
 ----------
 
-As shown in the example above, the bundle provides the ``@Model`` annotation.
+As shown in the example above, the bundle provides the ``#[Model]`` attribute.
 Use it instead of a definition reference and the bundle will deduce your model properties.
 
 .. note::
 
     A model can be a Symfony form type, a Doctrine ORM entity or a general PHP object.
 
-This annotation has two options:
+This attribute has two options:
 
 * ``type`` to specify your model's type::
 
@@ -397,12 +397,12 @@ that property type to not be nullable, for example.
 
 .. tip::
 
-     When used at the root of ``@OA\Response`` and ``@OA\Parameter``, ``@Model`` is automatically nested
-     in a ``@OA\Schema``.
+     When used at the root of ``#[OA\Response]`` and ``#[OA\Parameter]``, ``#[Model]`` is automatically nested
+     in a ``#[OA\Schema]``.
 
      The media type defaults to ``application/json``.
 
-     To use ``@Model`` directly within a ``@OA\Schema``, ``@OA\Items`` or ``@OA\Property``, you have to use the ``$ref`` field::
+     To use ``#[Model]`` directly within a ``#[OA\Schema]``, ``#[OA\Items]`` or ``#[OA\Property]``, you have to use the ``$ref`` field::
 
 .. configuration-block::
 
@@ -462,12 +462,12 @@ General PHP objects
 .. tip::
 
     **If you're not using the JMS Serializer**, the `Symfony PropertyInfo component`_ is used to describe your models.
-    It supports doctrine annotations, type hints, and even PHP doc blocks.
+    It supports doctrine attributes/annotations, type hints, and even PHP doc blocks.
     It does also support serialization groups when using the Symfony serializer.
 
     **If you're using the JMS Serializer**, the metadata of the JMS serializer are used by default to describe your
     models. Additional information is extracted from the PHP doc block comment,
-    but the property types must be specified in the JMS annotations.
+    but the property types must be specified in the JMS attributes/annotations.
 
     NOTE: If you are using serialization contexts (e.g. Groups) each permutation will be treated as a separate Path. For example if you have the following two variations defined in different places in your code:
 
@@ -524,14 +524,14 @@ General PHP objects
     When using the JMS serializer combined with `willdurand/Hateoas`_ (and the `BazingaHateoasBundle`_),
     HATEOAS metadata are automatically extracted
 
-If you want to customize the documentation of an object's property, you can use ``@OA\Property``::
+If you want to customize the documentation of an object's property, you can use ``#[OA\Property]``::
 
 
 .. configuration-block::
 
     .. code-block:: php-annotations
 
-        use Nelmio\ApiDocBundle\Annotation\Model;
+        use Nelmio\ApiDocBundle\Attribute\Model;
         use OpenApi\Annotations as OA;
 
         class User
@@ -562,7 +562,7 @@ If you want to customize the documentation of an object's property, you can use
 
     .. code-block:: php-attributes
 
-        use Nelmio\ApiDocBundle\Annotation\Model;
+        use Nelmio\ApiDocBundle\Attribute\Model;
         use OpenApi\Attributes as OA;
 
         class User
@@ -585,7 +585,7 @@ If you want to customize the documentation of an object's property, you can use
             }
         }
 
-See the `OpenAPI 3.0 specification`__ to see all the available fields of ``@OA\Property``.
+See the `OpenAPI 3.0 specification`__ to see all the available fields of ``#[@OA\Property]``.
 
 __ https://swagger.io/specification/
 
diff --git a/docs/security.rst b/docs/security.rst
index ca8f915a2..cfa9b0c47 100644
--- a/docs/security.rst
+++ b/docs/security.rst
@@ -24,7 +24,7 @@ This will add the Bearer security policy to all registered paths.
 Overriding Specific Paths
 -------------------------
 
-The security policy can be overridden for a path using the ``Security`` annotation/attribute.
+The security policy can be overridden for a path using the ``Security`` attribute/annotation.
 
 .. configuration-block::
 
@@ -38,7 +38,7 @@ The security policy can be overridden for a path using the ``Security`` annotati
 
         #[Security(name: "ApiKeyAuth")]
 
-Notice at the bottom of the docblock is a ``Security`` annotation/attribute with a name of `ApiKeyAuth`. This will override the global security policy to only accept the ``ApiKeyAuth`` policy for this path.
+Notice at the bottom of the docblock is a ``Security`` attribute/annotation with a name of `ApiKeyAuth`. This will override the global security policy to only accept the ``ApiKeyAuth`` policy for this path.
 
 You can also completely remove security from a path by providing ``Security`` with a name of ``null``.
 
diff --git a/phpstan-baseline.neon b/phpstan-baseline.neon
index 6c228bec1..4754d1794 100644
--- a/phpstan-baseline.neon
+++ b/phpstan-baseline.neon
@@ -1,5 +1,25 @@
 parameters:
 	ignoreErrors:
+		-
+			message: "#^Class Nelmio\\\\ApiDocBundle\\\\Annotation\\\\Areas extends @final class Nelmio\\\\ApiDocBundle\\\\Attribute\\\\Areas\\.$#"
+			count: 1
+			path: src/Annotation/Areas.php
+
+		-
+			message: "#^Class Nelmio\\\\ApiDocBundle\\\\Annotation\\\\Model extends @final class Nelmio\\\\ApiDocBundle\\\\Attribute\\\\Model\\.$#"
+			count: 1
+			path: src/Annotation/Model.php
+
+		-
+			message: "#^Class Nelmio\\\\ApiDocBundle\\\\Annotation\\\\Operation extends @final class Nelmio\\\\ApiDocBundle\\\\Attribute\\\\Operation\\.$#"
+			count: 1
+			path: src/Annotation/Operation.php
+
+		-
+			message: "#^Class Nelmio\\\\ApiDocBundle\\\\Annotation\\\\Security extends @final class Nelmio\\\\ApiDocBundle\\\\Attribute\\\\Security\\.$#"
+			count: 1
+			path: src/Annotation/Security.php
+
 		-
 			message: "#^Only booleans are allowed in an if condition, mixed given\\.$#"
 			count: 1
diff --git a/phpunit-ignore.txt b/phpunit-ignore.txt
index 654a2bcf3..c62fbbb5f 100644
--- a/phpunit-ignore.txt
+++ b/phpunit-ignore.txt
@@ -1,2 +1,5 @@
 # Ignoring deprecations from Nelmio\ApiDocBundle 4.17.0
 /^Since nelmio\/api-doc-bundle 4\.17\.0: Using the \$groups parameter of "Nelmio\\ApiDocBundle\\PropertyDescriber\\(PropertyDescriber|IntegerPropertyDescriber|NullablePropertyDescriber|StringPropertyDescriber|ObjectPropertyDescriber)::describe\(\)" is deprecated/
+
+# Ignoring deprecations from Nelmio\ApiDocBundle 4.32.3
+/^Since nelmio\/api-doc-bundle 4\.32\.3: The "Nelmio\\ApiDocBundle\\Annotation\\(Operation|Security|Areas|Model)" class is deprecated and will be removed in 5\.0\. Use the "\\Nelmio\\ApiDocBundle\\Attribute\\(Operation|Security|Areas|Model)" attribute instead\./
\ No newline at end of file
diff --git a/src/Annotation/Areas.php b/src/Annotation/Areas.php
index 50670a044..5aab701a1 100644
--- a/src/Annotation/Areas.php
+++ b/src/Annotation/Areas.php
@@ -11,44 +11,12 @@
 
 namespace Nelmio\ApiDocBundle\Annotation;
 
+trigger_deprecation('nelmio/api-doc-bundle', '4.32.3', 'The "%s" class is deprecated and will be removed in 5.0. Use the "\Nelmio\ApiDocBundle\Attribute\Areas" attribute instead.', Areas::class);
+
 /**
  * @Annotation
  */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
-final class Areas
+final class Areas extends \Nelmio\ApiDocBundle\Attribute\Areas
 {
-    /** @var string[] */
-    private array $areas;
-
-    /**
-     * @param string[]|array{value: string[]} $properties
-     */
-    public function __construct(array $properties)
-    {
-        if (!array_key_exists('value', $properties) || !is_array($properties['value'])) {
-            $properties['value'] = array_values($properties);
-        }
-
-        if ([] === $properties['value']) {
-            throw new \InvalidArgumentException('An array of areas was expected');
-        }
-
-        $areas = [];
-        foreach ($properties['value'] as $area) {
-            if (!is_string($area)) {
-                throw new \InvalidArgumentException('An area must be given as a string');
-            }
-
-            if (!in_array($area, $areas, true)) {
-                $areas[] = $area;
-            }
-        }
-
-        $this->areas = $areas;
-    }
-
-    public function has(string $area): bool
-    {
-        return in_array($area, $this->areas, true);
-    }
 }
diff --git a/src/Annotation/Model.php b/src/Annotation/Model.php
index 7f472d238..7995fc0f2 100644
--- a/src/Annotation/Model.php
+++ b/src/Annotation/Model.php
@@ -11,63 +11,12 @@
 
 namespace Nelmio\ApiDocBundle\Annotation;
 
-use OpenApi\Annotations\Parameter;
-use OpenApi\Attributes\Attachable;
-use OpenApi\Generator;
+trigger_deprecation('nelmio/api-doc-bundle', '4.32.3', 'The "%s" class is deprecated and will be removed in 5.0. Use the "\Nelmio\ApiDocBundle\Attribute\Model" attribute instead.', Model::class);
 
 /**
  * @Annotation
  */
 #[\Attribute(\Attribute::TARGET_METHOD)]
-final class Model extends Attachable
+final class Model extends \Nelmio\ApiDocBundle\Attribute\Model
 {
-    public static $_types = [
-        'type' => 'string',
-        'groups' => '[string]',
-        'options' => '[mixed]',
-    ];
-
-    public static $_required = ['type'];
-
-    public static $_parents = [
-        Parameter::class,
-    ];
-
-    public string $type;
-
-    /**
-     * @var string[]|null
-     */
-    public ?array $groups;
-
-    /**
-     * @var mixed[]|null
-     */
-    public ?array $options;
-
-    /**
-     * @var array<string, mixed>
-     */
-    public array $serializationContext;
-
-    /**
-     * @param mixed[]              $properties
-     * @param string[]             $groups
-     * @param mixed[]              $options
-     * @param array<string, mixed> $serializationContext
-     */
-    public function __construct(
-        array $properties = [],
-        string $type = Generator::UNDEFINED,
-        ?array $groups = null,
-        ?array $options = null,
-        array $serializationContext = []
-    ) {
-        parent::__construct($properties + [
-            'type' => $type,
-            'groups' => $groups,
-            'options' => $options,
-            'serializationContext' => $serializationContext,
-        ]);
-    }
 }
diff --git a/src/Annotation/Operation.php b/src/Annotation/Operation.php
index 9eb075e7d..4c632cf42 100644
--- a/src/Annotation/Operation.php
+++ b/src/Annotation/Operation.php
@@ -11,12 +11,12 @@
 
 namespace Nelmio\ApiDocBundle\Annotation;
 
-use OpenApi\Annotations\Operation as BaseOperation;
+trigger_deprecation('nelmio/api-doc-bundle', '4.32.3', 'The "%s" class is deprecated and will be removed in 5.0. Use the "\Nelmio\ApiDocBundle\Attribute\Operation" attribute instead.', Operation::class);
 
 /**
  * @Annotation
  */
 #[\Attribute(\Attribute::TARGET_METHOD)]
-class Operation extends BaseOperation
+class Operation extends \Nelmio\ApiDocBundle\Attribute\Operation
 {
 }
diff --git a/src/Annotation/Security.php b/src/Annotation/Security.php
index ffbf2b6a7..7d1c7536f 100644
--- a/src/Annotation/Security.php
+++ b/src/Annotation/Security.php
@@ -11,40 +11,12 @@
 
 namespace Nelmio\ApiDocBundle\Annotation;
 
-use OpenApi\Annotations\AbstractAnnotation;
+trigger_deprecation('nelmio/api-doc-bundle', '4.32.3', 'The "%s" class is deprecated and will be removed in 5.0. Use the "\Nelmio\ApiDocBundle\Attribute\Security" attribute instead.', Security::class);
 
 /**
  * @Annotation
  */
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
-class Security extends AbstractAnnotation
+class Security extends \Nelmio\ApiDocBundle\Attribute\Security
 {
-    public static $_types = [
-        'name' => 'string',
-        'scopes' => '[string]',
-    ];
-
-    public static $_required = ['name'];
-
-    public ?string $name;
-
-    /**
-     * @var string[]
-     */
-    public array $scopes = [];
-
-    /**
-     * @param array<string, mixed> $properties
-     * @param string[]             $scopes
-     */
-    public function __construct(
-        array $properties = [],
-        ?string $name = null,
-        array $scopes = []
-    ) {
-        parent::__construct($properties + [
-            'name' => $name,
-            'scopes' => $scopes,
-        ]);
-    }
 }
diff --git a/src/Attribute/Areas.php b/src/Attribute/Areas.php
new file mode 100644
index 000000000..1cf16af84
--- /dev/null
+++ b/src/Attribute/Areas.php
@@ -0,0 +1,54 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Attribute;
+
+/**
+ * @final
+ */
+#[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
+class Areas
+{
+    /** @var string[] */
+    private array $areas;
+
+    /**
+     * @param string[]|array{value: string[]} $properties
+     */
+    public function __construct(array $properties)
+    {
+        if (!array_key_exists('value', $properties) || !is_array($properties['value'])) {
+            $properties['value'] = array_values($properties);
+        }
+
+        if ([] === $properties['value']) {
+            throw new \InvalidArgumentException('An array of areas was expected');
+        }
+
+        $areas = [];
+        foreach ($properties['value'] as $area) {
+            if (!is_string($area)) {
+                throw new \InvalidArgumentException('An area must be given as a string');
+            }
+
+            if (!in_array($area, $areas, true)) {
+                $areas[] = $area;
+            }
+        }
+
+        $this->areas = $areas;
+    }
+
+    public function has(string $area): bool
+    {
+        return in_array($area, $this->areas, true);
+    }
+}
diff --git a/src/Attribute/Model.php b/src/Attribute/Model.php
new file mode 100644
index 000000000..67be0c493
--- /dev/null
+++ b/src/Attribute/Model.php
@@ -0,0 +1,73 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Attribute;
+
+use OpenApi\Annotations\Parameter;
+use OpenApi\Attributes\Attachable;
+use OpenApi\Generator;
+
+/**
+ * @final
+ */
+#[\Attribute(\Attribute::TARGET_METHOD)]
+class Model extends Attachable
+{
+    public static $_types = [
+        'type' => 'string',
+        'groups' => '[string]',
+        'options' => '[mixed]',
+    ];
+
+    public static $_required = ['type'];
+
+    public static $_parents = [
+        Parameter::class,
+    ];
+
+    public string $type;
+
+    /**
+     * @var string[]|null
+     */
+    public ?array $groups;
+
+    /**
+     * @var mixed[]|null
+     */
+    public ?array $options;
+
+    /**
+     * @var array<string, mixed>
+     */
+    public array $serializationContext;
+
+    /**
+     * @param mixed[]              $properties
+     * @param string[]             $groups
+     * @param mixed[]              $options
+     * @param array<string, mixed> $serializationContext
+     */
+    public function __construct(
+        array $properties = [],
+        string $type = Generator::UNDEFINED,
+        ?array $groups = null,
+        ?array $options = null,
+        array $serializationContext = []
+    ) {
+        parent::__construct($properties + [
+            'type' => $type,
+            'groups' => $groups,
+            'options' => $options,
+            'serializationContext' => $serializationContext,
+        ]);
+    }
+}
diff --git a/src/Attribute/Operation.php b/src/Attribute/Operation.php
new file mode 100644
index 000000000..f0107f38d
--- /dev/null
+++ b/src/Attribute/Operation.php
@@ -0,0 +1,22 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Attribute;
+
+use OpenApi\Annotations\Operation as BaseOperation;
+
+/**
+ * @final
+ */
+#[\Attribute(\Attribute::TARGET_METHOD)]
+class Operation extends BaseOperation
+{
+}
diff --git a/src/Attribute/Security.php b/src/Attribute/Security.php
new file mode 100644
index 000000000..1799351dd
--- /dev/null
+++ b/src/Attribute/Security.php
@@ -0,0 +1,50 @@
+<?php
+
+/*
+ * This file is part of the NelmioApiDocBundle package.
+ *
+ * (c) Nelmio
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Nelmio\ApiDocBundle\Attribute;
+
+use OpenApi\Annotations\AbstractAnnotation;
+
+/**
+ * @final
+ */
+#[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
+class Security extends AbstractAnnotation
+{
+    public static $_types = [
+        'name' => 'string',
+        'scopes' => '[string]',
+    ];
+
+    public static $_required = ['name'];
+
+    public ?string $name;
+
+    /**
+     * @var string[]
+     */
+    public array $scopes = [];
+
+    /**
+     * @param array<string, mixed> $properties
+     * @param string[]             $scopes
+     */
+    public function __construct(
+        array $properties = [],
+        ?string $name = null,
+        array $scopes = []
+    ) {
+        parent::__construct($properties + [
+            'name' => $name,
+            'scopes' => $scopes,
+        ]);
+    }
+}
diff --git a/src/Describer/OpenApiPhpDescriber.php b/src/Describer/OpenApiPhpDescriber.php
index 20cc958de..898d1334d 100644
--- a/src/Describer/OpenApiPhpDescriber.php
+++ b/src/Describer/OpenApiPhpDescriber.php
@@ -12,8 +12,8 @@
 namespace Nelmio\ApiDocBundle\Describer;
 
 use Doctrine\Common\Annotations\Reader;
-use Nelmio\ApiDocBundle\Annotation\Operation;
-use Nelmio\ApiDocBundle\Annotation\Security;
+use Nelmio\ApiDocBundle\Attribute\Operation;
+use Nelmio\ApiDocBundle\Attribute\Security;
 use Nelmio\ApiDocBundle\OpenApiPhp\Util;
 use Nelmio\ApiDocBundle\Util\ControllerReflector;
 use Nelmio\ApiDocBundle\Util\SetsContextTrait;
diff --git a/src/OpenApiPhp/ModelRegister.php b/src/OpenApiPhp/ModelRegister.php
index de20ee6bb..7a70bb5fd 100644
--- a/src/OpenApiPhp/ModelRegister.php
+++ b/src/OpenApiPhp/ModelRegister.php
@@ -11,7 +11,7 @@
 
 namespace Nelmio\ApiDocBundle\OpenApiPhp;
 
-use Nelmio\ApiDocBundle\Annotation\Model as ModelAnnotation;
+use Nelmio\ApiDocBundle\Attribute\Model as ModelAnnotation;
 use Nelmio\ApiDocBundle\Model\Model;
 use Nelmio\ApiDocBundle\Model\ModelRegistry;
 use OpenApi\Analysis;
diff --git a/src/Routing/FilteredRouteCollectionBuilder.php b/src/Routing/FilteredRouteCollectionBuilder.php
index b634f8702..97715c8fb 100644
--- a/src/Routing/FilteredRouteCollectionBuilder.php
+++ b/src/Routing/FilteredRouteCollectionBuilder.php
@@ -12,7 +12,8 @@
 namespace Nelmio\ApiDocBundle\Routing;
 
 use Doctrine\Common\Annotations\Reader;
-use Nelmio\ApiDocBundle\Annotation\Areas;
+use Nelmio\ApiDocBundle\Annotation\Areas as LegacyAreas;
+use Nelmio\ApiDocBundle\Attribute\Areas;
 use Nelmio\ApiDocBundle\Util\ControllerReflector;
 use OpenApi\Annotations\AbstractAnnotation;
 use Symfony\Component\OptionsResolver\OptionsResolver;
@@ -143,11 +144,11 @@ private function matchAnnotation(Route $route): bool
                 /** @var Areas|null $areas */
                 $areas = $this->annotationReader->getMethodAnnotation(
                     $reflectionMethod,
-                    Areas::class
+                    LegacyAreas::class
                 );
 
                 if (null === $areas) {
-                    $areas = $this->annotationReader->getClassAnnotation($reflectionMethod->getDeclaringClass(), Areas::class);
+                    $areas = $this->annotationReader->getClassAnnotation($reflectionMethod->getDeclaringClass(), LegacyAreas::class);
                 }
             }
         }
@@ -181,6 +182,7 @@ private function defaultRouteDisabled(Route $route): bool
 
         foreach ($annotations as $annotation) {
             if (false !== strpos(get_class($annotation), 'Nelmio\\ApiDocBundle\\Annotation')
+                || false !== strpos(get_class($annotation), 'Nelmio\\ApiDocBundle\\Attribute')
                 || false !== strpos(get_class($annotation), 'OpenApi\\Annotations')
                 || false !== strpos(get_class($annotation), 'OpenApi\\Attributes')
             ) {