diff --git a/.php-cs-fixer.dist.php b/.php-cs-fixer.dist.php
index 859bfa8eb..8527d9c7d 100644
--- a/.php-cs-fixer.dist.php
+++ b/.php-cs-fixer.dist.php
@@ -7,6 +7,7 @@
     ->path('src')->name('*.php')
     ->path('tools')->name('*.php')
     ->path('docs/examples')->name('*.php')
+    ->path('docs/snippets')->name('*.php')
     ->path('tests')->name('*.php')
     ->filter(function (\SplFileInfo $file) {
         return
diff --git a/docs/guide/common-techniques.md b/docs/guide/common-techniques.md
index 31286abd3..ae6e8786e 100644
--- a/docs/guide/common-techniques.md
+++ b/docs/guide/common-techniques.md
@@ -20,22 +20,19 @@ a structural element (`class`, `method`, `parameter` or `enum`)
 This means in a lot of cases it is not necessary to explicitly document all details.
 
 **Example**
-```php
-<?php
 
-/**
- * @OA\Schema()
- */
-class Product {
+<codeblock id="context-awareness">
+  <template v-slot:at>
 
-    /**
-     * The product name,
-     * @var string
-     * @OA\Property()
-     */
-    public $name;
-}
-```
+<<< @/snippets/guide/common-techniques/context_awareness_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/context_awareness_an.php
+
+  </template>
+</codeblock>
 
 **Results in**
 ```yaml
@@ -52,48 +49,50 @@ components:
 
 **As if you'd written**
 
-```php
-    /**
-     * The product name
-     * @var string
-     *
-     * @OA\Property(
-     *   property="name",
-     *   type="string",
-     *   description="The product name"
-     * )
-     */
-    public $name;
-```
+<codeblock id="explicit-context">
+  <template v-slot:at>
+
+<<< @/snippets/guide/common-techniques/explicit_context_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/explicit_context_an.php
+
+  </template>
+</codeblock>
 
 ## Response media type
 
 The `@OA\MediaType` is used to describe the content:
 
-```php
-/**
- * @OA\Response(
- *     response=200,
- *     description="successful operation",
- *     @OA\MediaType(
- *         mediaType="application/json",
- *         @OA\Schema(ref="#/components/schemas/User"),
- *     )
- * ),
- */
-```
+<codeblock id="response-media-type">
+  <template v-slot:at>
+
+<<< @/snippets/guide/common-techniques/response_media_type_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/response_media_type_an.php
+
+  </template>
+</codeblock>
 
 But because most API requests and responses are JSON, the `@OA\JsonContent` allows you to simplify this by writing:
 
-```php
-/**
- * @OA\Response(
- *     response=200,
- *     description="successful operation",
- *     @OA\JsonContent(ref="#/components/schemas/User"),
- * )
- */
-```
+<codeblock id="response-json-content">
+  <template v-slot:at>
+
+<<< @/snippets/guide/common-techniques/response_json_content_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/response_json_content_an.php
+
+  </template>
+</codeblock>
 
 During processing the `@OA\JsonContent` unfolds to `@OA\MediaType( mediaType="application/json", @OA\Schema(...)`
 and will generate the same output.
@@ -103,6 +102,21 @@ and will generate the same output.
 It's quite common that endpoints have some overlap in either their request or response data.
 To keep things DRY (Don't Repeat Yourself) the specification allows reusing components using `$ref`'s
 
+<codeblock id="using-references">
+  <template v-slot:at>
+
+```php
+#[OA\Schema(
+  schema: 'product_id',
+  type: 'integer',
+  format: 'int64',
+  description: 'The unique identifier of a product in our catalog',
+)]
+```
+
+  </template>
+  <template v-slot:an>
+
 ```php
 /**
  * @OA\Schema(
@@ -114,6 +128,9 @@ To keep things DRY (Don't Repeat Yourself) the specification allows reusing comp
  */
 ```
 
+  </template>
+</codeblock>
+
 **Results in:**
 
 ```yaml
@@ -128,6 +145,17 @@ components:
 
 This doesn't do anything by itself, but now you can reference this fragment by its path in the document tree `#/components/schemas/product_id`
 
+<codeblock id="refer-to-$ref">
+  <template v-slot:at>
+
+```php
+    #[OA\Property(ref: "#/components/schemas/product_id")]
+    public $id;
+```
+
+  </template>
+  <template v-slot:an>
+
 ```php
     /**
      * @OA\Property(ref="#/components/schemas/product_id")
@@ -135,6 +163,9 @@ This doesn't do anything by itself, but now you can reference this fragment by i
     public $id;
 ```
 
+  </template>
+</codeblock>
+
 ::: info Examples
 There are more uses cases on how to use refs in the [using-refs example](https://github.com/zircote/swagger-php/tree/master/examples/specs/using-refs).
 :::
@@ -153,24 +184,18 @@ The specification allows for [custom properties](http://swagger.io/specification
 as long as they start with "x-". Therefore, all swagger-php annotations have an `x` property which accepts an array (map)
 and will unfold into "x-" properties.
 
-```php
-/**
- * @OA\Info(
- *   title="Example",
- *   version="1.0.0",
- *   x={
- *     "some-name": "a-value",
- *     "another": 2,
- *     "complex-type": {
- *       "supported":{
- *         {"version": "1.0", "level": "baseapi"},
- *         {"version": "2.1", "level": "fullapi"},
- *       }
- *     }
- *   }
- * )
- */
-```
+<codeblock id="custom-property">
+  <template v-slot:at>
+
+<<< @/snippets/guide/common-techniques/custom_property_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/custom_property_an.php
+
+  </template>
+</codeblock>
 
 **Results in:**
 
@@ -199,23 +224,18 @@ Enum cases can be used as value in an `enum` list just like a `string`, `integer
 
 **Basic enum:**
 
-```php
-use OpenApi\Attributes as OAT;
-
-enum Suit
-{
-    case Hearts;
-    case Diamonds;
-    case Clubs;
-    case Spades;
-}
-
-class Model
-{
-    #[OAT\Property(enum: [Suit::Hearts, Suit::Diamonds])]
-    protected array $someSuits;
-}
-```
+<codeblock id="enum-as-values">
+  <template v-slot:at>
+
+<<< @/snippets/guide/common-techniques/enum_as_values_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/enum_as_values_an.php
+
+  </template>
+</codeblock>
 
 **Results in:**
 
@@ -242,24 +262,18 @@ If the enum is a backed enum, the case backing value is used instead of the name
 
 The simples way of using enums is to annotate them as `Schema`. This allows you to reference them like any other schema in your spec.
 
-```php
-use OpenApi\Attributes as OAT;
-
-#[OAT\Schema()]
-enum Colour
-{
-    case GREEN;
-    case BLUE;
-    case RED;
-}
-
-#[OAT\Schema()]
-class Product
-{
-    #[OAT\Property()]
-    public Colour $colour;
-}
-```
+<codeblock id="enum-as-schema">
+  <template v-slot:at>
+
+<<< @/snippets/guide/common-techniques/enum_as_schema_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/enum_as_schema_an.php
+
+  </template>
+</codeblock>
 
 **Results in:**
 
@@ -288,24 +302,18 @@ For backed enums there exist two rules that determine whether the name or backin
 
 **Using the name of a backed enum:**
 
-```php
-use OpenApi\Attributes as OAT;
-
-#[OAT\Schema()]
-enum Colour: int
-{
-    case GREEN = 1;
-    case BLUE = 2;
-    case RED = 3;
-}
-
-#[OAT\Schema()]
-class Product
-{
-    #[OAT\Property()]
-    public Colour $colour;
-}
-```
+<codeblock id="backed-enum-names-as-schema">
+  <template v-slot:at>
+
+<<< @/snippets/guide/common-techniques/backed_enum_names_as_schema_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/backed_enum_names_as_schema_an.php
+
+  </template>
+</codeblock>
 
 **Results in:**
 
@@ -328,24 +336,18 @@ components:
 
 **Using the backing value:**
 
-```php
-use OpenApi\Attributes as OAT;
-
-#[OAT\Schema(type: 'integer')]
-enum Colour: int
-{
-    case GREEN = 1;
-    case BLUE = 2;
-    case RED = 3;
-}
-
-#[OAT\Schema()]
-class Product
-{
-    #[OAT\Property()]
-    public Colour $colour;
-}
-```
+<codeblock id="backed-enum-values-as-schema">
+  <template v-slot:at>
+
+<<< @/snippets/guide/common-techniques/backed_enum_values_as_schema_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/common-techniques/backed_enum_values_as_schema_an.php
+
+  </template>
+</codeblock>
 
 **Results in:**
 
diff --git a/docs/guide/cookbook.md b/docs/guide/cookbook.md
index cd722a95b..b8b474c7a 100644
--- a/docs/guide/cookbook.md
+++ b/docs/guide/cookbook.md
@@ -5,49 +5,49 @@ OpenApi has the concept of grouping endpoints using tags. On top of that, some t
 ([redocly](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/), for example)
 support further grouping via the vendor extension `x-tagGroups`.
 
-```php
-/**
- * @OA\OpenApi(
- *   x={
- *       "tagGroups"=
- *           {{"name"="User Management", "tags"={"Users", "API keys", "Admin"}}
- *       }
- *   }
- * )
- */
-```
+<codeblock id="x-tag-groups">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/x_tag_groups_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/x_tag_groups_an.php
+
+  </template>
+</codeblock>
 
 ## Adding examples to `@OA\Response`
-```php
-/*
- * @OA\Response(
- *     response=200,
- *     description="OK",
- *     @OA\JsonContent(
- *         oneOf={
- *             @OA\Schema(ref="#/components/schemas/Result"),
- *             @OA\Schema(type="boolean")
- *         },
- *         @OA\Examples(example="result", value={"success": true}, summary="An result object."),
- *         @OA\Examples(example="bool", value=false, summary="A boolean value."),
- *     )
- * )
- */
-```
+
+<codeblock id="response-examples">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/response_examples_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/response_examples_an.php
+
+  </template>
+</codeblock>
 
 ## External documentation
 OpenApi allows a single reference to external documentation. This is a part of the top level `@OA\OpenApi`.
 
-```php
-/**
- * @OA\OpenApi(
- *   @OA\ExternalDocumentation(
- *     description="More documentation here...",
- *     url="https://example.com/externaldoc1/"
- *   )
- * )
- */
-```
+<codeblock id="external-doc">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/external_documentation_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/external_documentation_an.php
+
+  </template>
+</codeblock>
 
 ::: tip
 If no `@OA\OpenApi` is configured, `swagger-php` will create one automatically.
@@ -67,30 +67,19 @@ That means the above example would also work with just the `OA\ExternalDocumenta
 ## Properties with union types
 Sometimes properties or even lists (arrays) may contain data of different types. This can be expressed using `oneOf`.
 
-```php
-/**
- * @OA\Schema(
- *      schema="StringList",
- *      @OA\Property(property="value", type="array", @OA\Items(anyOf={@OA\Schema(type="string")}))
- * )
- * @OA\Schema(
- *      schema="String",
- *      @OA\Property(property="value", type="string")
- * )
- * @OA\Schema(
- *      schema="Object",
- *      @OA\Property(property="value", type="object")
- * )
- * @OA\Schema(
- *     schema="mixedList",
- *     @OA\Property(property="fields", type="array", @OA\Items(oneOf={
- *         @OA\Schema(ref="#/components/schemas/StringList"),
- *         @OA\Schema(ref="#/components/schemas/String"),
- *         @OA\Schema(ref="#/components/schemas/Object")
- *     }))
- * )
- */
-```
+<codeblock id="props-with-union-types">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/properties_with_union_types_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/properties_with_union_types_an.php
+
+  </template>
+</codeblock>
+
 
 This will resolve into this YAML
 ```yaml
@@ -134,145 +123,97 @@ components:
 ## Referencing a security scheme
 An API might have zero or more security schemes. These are defined at the top level and vary from simple to complex:
 
-```php
-/**
- * @OA\SecurityScheme(
- *     type="apiKey",
- *     name="api_key",
- *     in="header",
- *     securityScheme="api_key"
- * )
- *
- * @OA\SecurityScheme(
- *   type="oauth2",
- *   securityScheme="petstore_auth",
- *   @OA\Flow(
- *      authorizationUrl="http://petstore.swagger.io/oauth/dialog",
- *      flow="implicit",
- *      scopes={
- *         "read:pets": "read your pets",
- *         "write:pets": "modify pets in your account"
- *      }
- *   )
- * )
- */
-```
+<codeblock id="security-schemas">
+  <template v-slot:at>
 
+<<< @/snippets/guide/cookbook/security_schemas_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/security_schemas_an.php
+
+  </template>
+</codeblock>
 
 To declare an endpoint as secure and define what security schemes are available to authenticate a client it needs to be
 added to the operation, for example:
-```php
-/**
- * @OA\Get(
- *      path="/api/secure/",
- *      summary="Requires authentication"
- *    ),
- *    security={ {"api_key": {}} }
- * )
- */
-```
+
+<codeblock id="secure-endpoint">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/secure_endpoint_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/secure_endpoint_an.php
+
+  </template>
+</codeblock>
 
 ::: tip Endpoints can support multiple security schemes and have custom options too:
-```php
-/**
- * @OA\Get(
- *      path="/api/secure/",
- *      summary="Requires authentication"
- *    ),
- *    security={
- *      { "api_key": {} },
- *      { "petstore_auth": {"write:pets", "read:pets"} }
- *    }
- * )
- */
-```
+<codeblock id="security-schema-tips">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/security_schema_tips_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/security_schema_tips_an.php
+
+  </template>
+</codeblock>
 :::
 
 ## File upload with headers
-```php
-/**
- * @OA\Post(
- *   path="/v1/media/upload",
- *   summary="Upload document",
- *   description="",
- *   tags={"Media"},
- *   @OA\RequestBody(
- *     required=true,
- *     @OA\MediaType(
- *       mediaType="application/octet-stream",
- *       @OA\Schema(
- *         required={"content"},
- *         @OA\Property(
- *           description="Binary content of file",
- *           property="content",
- *           type="string",
- *           format="binary"
- *         )
- *       )
- *     )
- *   ),
- *   @OA\Response(
- *     response=200, description="Success",
- *     @OA\Schema(type="string")
- *   ),
- *   @OA\Response(
- *     response=400, description="Bad Request"
- *   )
- * )
- */
-```
+
+<codeblock id="file-upload-with-headers">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/file_upload_with_headers_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/file_upload_with_headers_an.php
+
+  </template>
+</codeblock>
+
 ## Set the XML root name
 
 The `OA\Xml` annotation may be used to set the XML root element for a given `@OA\XmlContent` response body
 
-```php
-/**
- * @OA\Schema(
- *     schema="Error",
- *     @OA\Property(property="message"),
- *     @OA\Xml(name="details")
- * )
- */
+<codeblock id="set-xml-root-name">
+  <template v-slot:at>
 
-/**
- * @OA\Post(
- *     path="/foobar",
- *     @OA\Response(
- *         response=400,
- *         description="Request error",
- *         @OA\XmlContent(ref="#/components/schemas/Error",
- *           @OA\Xml(name="error")
- *        )
- *     )
- * )
- */
- ```
+<<< @/snippets/guide/cookbook/set_xml_root_name_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/set_xml_root_name_an.php
+
+  </template>
+</codeblock>
 
 ## upload multipart/form-data
 Form posts are `@OA\Post` requests with a `multipart/form-data` `@OA\RequestBody`. The relevant bit looks something like this
-```php
-/**
- * @OA\Post(
- *   path="/v1/user/update",
- *   summary="Form post",
- *   @OA\RequestBody(
- *     @OA\MediaType(
- *       mediaType="multipart/form-data",
- *       @OA\Schema(
- *         @OA\Property(property="name"),
- *         @OA\Property(
- *           description="file to upload",
- *           property="avatar",
- *           type="string",
- *           format="binary",
- *         ),
- *       )
- *     )
- *   ),
- *   @OA\Response(response=200, description="Success")
- * )
- */
-```
+
+<codeblock id="upload-multipart-form-data">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/uploading_multipart_formdata_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/uploading_multipart_formdata_an.php
+
+  </template>
+</codeblock>
 
 ## Default security scheme for all endpoints
 Unless specified each endpoint needs to declare what security schemes it supports. However, there is a way
@@ -295,92 +236,51 @@ This is done on the `@OA\OpenApi` annotation:
 
 ## Nested objects
 Complex, nested data structures are defined by nesting `@OA\Property` annotations inside others (with `type="object"`).
-```php
-/**
- *  @OA\Schema(
- *    schema="Profile",
- *    type="object",
-*
- *    @OA\Property(
- *      property="Status",
- *      type="string",
- *      example="0"
- *    ),
- *
- *    @OA\Property(
- *      property="Group",
- *      type="object",
- *
- *      @OA\Property(
- *        property="ID",
- *        description="ID de grupo",
- *        type="number",
- *        example=-1
- *      ),
- *
- *      @OA\Property(
- *        property="Name",
- *        description="Nombre de grupo",
- *        type="string",
- *        example="Superadmin"
- *      )
- *    )
- *  )
- */
 
-```
+<codeblock id="minimal">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/nested_objects_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/nested_objects_an.php
+
+  </template>
+</codeblock>
 
 ## Documenting union type response data using `oneOf`
 A response with either a single or a list of `QualificationHolder`'s.
-```php
-/**
- * @OA\Response(
- *     response=200,
- *     @OA\JsonContent(
- *         oneOf={
- *             @OA\Schema(ref="#/components/schemas/QualificationHolder"),
- *             @OA\Schema(
- *                 type="array",
- *                 @OA\Items(ref="#/components/schemas/QualificationHolder")
- *             )
- *         }
- *     )
- * )
- */
-```
+
+<codeblock id="oneof-example">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/oneof_example_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/oneof_example_an.php
+
+  </template>
+</codeblock>
 
 ## Reusing responses
 Global responses are found under `/components/responses` and can be referenced/shared just like schema definitions (models)
 
-```php
-/**
- * @OA\Response(
- *   response="product",
- *   description="All information about a product",
- *   @OA\JsonContent(ref="#/components/schemas/Product")
- * )
- */
-class ProductResponse {}
+<codeblock id="reusing-response">
+  <template v-slot:at>
 
- // ...
+<<< @/snippets/guide/cookbook/reusing_response_at.php
 
-class ProductController
-{
-    /**
-     * @OA\Get(
-     *   tags={"Products"},
-     *   path="/products/{product_id}",
-     *   @OA\Response(
-     *       response="default",
-     *       ref="#/components/responses/product"
-     *   )
-     * )
-     */
-    public function getProduct($id)
-    {
-    }
-}
-```
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/reusing_response_an.php
+
+  </template>
+</codeblock>
 
 ::: tip `response` parameter is always required
 Even if referencing a shared response definition, the `response` parameter is still required.
@@ -412,10 +312,50 @@ There are two scenarios where this can happen
 The API does include basic support for callbacks. However, this needs to be set up mostly manually.
 
 **Example**
+
+<tabs options="{ useUrlFragment: false }">
+  <tab id="at" name="Attributes">
+
+```php
+#[OA\Get(
+    // ...
+    callbacks: [
+        'onChange' => [
+            '{$request.query.callbackUrl}' => [
+                'post' => [
+                    'requestBody' => new OA\RequestBody(
+                        description: 'subscription payload',
+                        content: [
+                            new OA\MediaType(
+                                mediaType: 'application/json',
+                                schema: new OA\Schema(
+                                    properties: [
+                                        new OA\Property(
+                                            property: 'timestamp',
+                                            type: 'string',
+                                            format: 'date-time',
+                                            description: 'time of change'
+                                        ),
+                                    ],
+                                ),
+                            ),
+                        ],
+                    ),
+                ],
+            ],
+        ],
+    ],
+    // ...
+)]
+```
+
+  </tab>
+  <tab id="an" name="Annotations">
+
 ```php
 /**
+ * @OA\Get(
  *     ...
- *
  *     callbacks={
  *         "onChange"={
  *              "{$request.query.callbackUrl}"={
@@ -435,12 +375,14 @@ The API does include basic support for callbacks. However, this needs to be set
  *              }
  *         }
  *     }
- *
  *     ...
- *
+ * )
  */
 ```
 
+  </tab>
+</tabs>
+
 ## (Mostly) virtual models
 Typically, a model is annotated by adding a `@OA\Schema` annotation to the class and then individual `@OA\Property` annotations
 to the individually declared class properties.
@@ -448,17 +390,19 @@ to the individually declared class properties.
 It is possible, however, to nest `O@\Property` annotations inside a schema even without properties. In fact, all that is needed
 is a code anchor - e.g. an empty class.
 
-```php
-use OpenApi\Attributes as OA;
+<codeblock id="virtual-model">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/virtual_model_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/virtual_model_an.php
+
+  </template>
+</codeblock>
 
-#[OA\Schema(
-    properties: [
-        'name' => new OA\Property(property: 'name', type: 'string'),
-        'email' => new OA\Property(property: 'email', type: 'string'),
-    ]
-)]
-class User {}
-```
 
 ## Using class name as type instead of references
 Typically, when referencing schemas this is done using `$ref`'s
@@ -490,6 +434,9 @@ class name.
 
 With the same `User` schema as before, the `Book::author` property could be written in a few different ways
 
+<tabs options="{ useUrlFragment: false }">
+  <tab id="at" name="Attributes">
+
 ```php
     #[OAT\Property()]
     public User author;
@@ -508,10 +455,32 @@ With the same `User` schema as before, the `Book::author` property could be writ
 **or**
 
 ```php
-    #[OAT\Property(type: User::class)]
+    #[OA\Property(type: User::class)]
+    public author;
+```
+
+  </tab>
+
+  <tab id="an" name="Annotations">
+
+```php
+    /** @OA\Property() */
+    public User author;
+```
+
+**or**
+
+```php
+    /**
+     * @var User
+     * @OA\Property()
+     */
     public author;
 ```
 
+  </tab>
+</tabs>
+
 ## Enums
 As of PHP 8.1 there is native support for `enum`'s.
 
@@ -519,21 +488,18 @@ As of PHP 8.1 there is native support for `enum`'s.
 
 **Example**
 
-```php
-#[Schema()]
-enum State
-{
-    case OPEN;
-    case MERGED;
-    case DECLINED;
-}
+<codeblock id="enums">
+  <template v-slot:at>
 
-#[Schema()]
-class PullRequest
-   #[OAT\Property()]
-   public State $state
-}
-```
+<<< @/snippets/guide/cookbook/enums_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/enums_an.php
+
+  </template>
+</codeblock>
 
 However, in this case the schema generated for `State` will be an enum:
 
@@ -560,27 +526,19 @@ name uses trailing `[]`. In fact, it is possible to create nested arrays too by
 
 In terms of OpenAPI, the parameters can be considered a single parameter with a list of values.
 
-```php
-/**
- * @OA\Get(
- *     path="/api/endpoint",
- *     description="The endpoint",
- *     operationId="endpoint",
- *     tags={"endpoints"},
- *     @OA\Parameter(
- *         name="things[]",
- *         in="query",
- *         description="A list of things.",
- *         required=false,
- *         @OA\Schema(
- *             type="array",
- *             @OA\Items(type="integer")
- *         )
- *     ),
- *     @OA\Response(response="200", description="All good")
- * )
- */
-```
+<codeblock id="multi-value-query-parameter">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/multi_value_query_parameter_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/multi_value_query_parameter_an.php
+
+  </template>
+</codeblock>
+
 
 The corresponding bit of the spec will look like this:
 
@@ -609,6 +567,7 @@ The beauty is that in your custom `__construct()` method you can prefill as much
 Best of all, this works for both annotations and attributes.
 
 Example:
+
 ```php
 use OpenApi\Attributes as OA;
 
@@ -657,16 +616,20 @@ Furthermore, your custom annotations should extend from the `OpenApi\Annotations
 :::
 
 ## Annotating class constants
-```php
-use OpenApi\Attributes as OA;
 
-#[OA\Schema()]
-class Airport
-{
-    #[OA\Property(property='kind')]
-    public const KIND = 'Airport';
-}
-```
+<codeblock id="class-constants">
+  <template v-slot:at>
+
+<<< @/snippets/guide/cookbook/class_constants_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/cookbook/class_constants_an.php
+
+  </template>
+</codeblock>
+
 The `const` property is supported in OpenApi 3.1.0.
 ```yaml
 components:
diff --git a/docs/guide/faq.md b/docs/guide/faq.md
index 87bf9d962..37fcc92dd 100644
--- a/docs/guide/faq.md
+++ b/docs/guide/faq.md
@@ -24,27 +24,18 @@ related code, the info annotation (and a few more) is kind of global.
 The simplest solution to avoid this issue is to add a 'dummy' class to the docblock and add
 all 'global' annotations (e.g. `Tag`, `Server`, `SecurityScheme`, etc.) **in a single docblock** to that class.
 
-```php
-/**
- * @OA\Tag(
- *     name="user",
- *     description="User related operations"
- * )
- * @OA\Info(
- *     version="1.0",
- *     title="Example API",
- *     description="Example info",
- *     @OA\Contact(name="Swagger API Team")
- * )
- * @OA\Server(
- *     url="https://example.localhost",
- *     description="API server"
- * )
- */
-class OpenApiSpec
-{
-}
-```
+<codeblock id="dummy-class">
+  <template v-slot:at>
+
+<<< @/snippets/guide/faq/dummy_class_at.php
+
+  </template>
+  <template v-slot:an>
+
+<<< @/snippets/guide/faq/dummy_class_an.php
+
+  </template>
+</codeblock>
 
 **As of version 4.8 the `doctrine/annotations` library is optional and might cause the same message.**
 
diff --git a/docs/snippets/guide/common-techniques/backed_enum_names_as_schema_an.php b/docs/snippets/guide/common-techniques/backed_enum_names_as_schema_an.php
new file mode 100644
index 000000000..899fec098
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/backed_enum_names_as_schema_an.php
@@ -0,0 +1,24 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema()
+ */
+enum Colour: int
+{
+    case GREEN = 1;
+    case BLUE = 2;
+    case RED = 3;
+}
+
+/**
+ * @OA\Schema
+ */
+class Product
+{
+    /**
+     * @OA\Property
+     */
+    public Colour $colour;
+}
diff --git a/docs/snippets/guide/common-techniques/backed_enum_names_as_schema_at.php b/docs/snippets/guide/common-techniques/backed_enum_names_as_schema_at.php
new file mode 100644
index 000000000..d9e8bc5fe
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/backed_enum_names_as_schema_at.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema()]
+enum Colour: int
+{
+    case GREEN = 1;
+    case BLUE = 2;
+    case RED = 3;
+}
+
+#[OA\Schema()]
+class Product
+{
+    #[OA\Property()]
+    public Colour $colour;
+}
diff --git a/docs/snippets/guide/common-techniques/backed_enum_values_as_schema_an.php b/docs/snippets/guide/common-techniques/backed_enum_values_as_schema_an.php
new file mode 100644
index 000000000..6559356d8
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/backed_enum_values_as_schema_an.php
@@ -0,0 +1,24 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema(type="integer")
+ */
+enum Colour: int
+{
+    case GREEN = 1;
+    case BLUE = 2;
+    case RED = 3;
+}
+
+/**
+ * @OA\Schema
+ */
+class Product
+{
+    /**
+     * @OA\Property
+     */
+    public Colour $colour;
+}
diff --git a/docs/snippets/guide/common-techniques/backed_enum_values_as_schema_at.php b/docs/snippets/guide/common-techniques/backed_enum_values_as_schema_at.php
new file mode 100644
index 000000000..6452295ae
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/backed_enum_values_as_schema_at.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(type: 'integer')]
+enum Colour: int
+{
+    case GREEN = 1;
+    case BLUE = 2;
+    case RED = 3;
+}
+
+#[OA\Schema()]
+class Product
+{
+    #[OA\Property()]
+    public Colour $colour;
+}
diff --git a/docs/snippets/guide/common-techniques/context_awareness_an.php b/docs/snippets/guide/common-techniques/context_awareness_an.php
new file mode 100644
index 000000000..38a5ba3f7
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/context_awareness_an.php
@@ -0,0 +1,16 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema
+ */
+class Product
+{
+    /**
+     * The product name,.
+     * @var string
+     * @OA\Property
+     */
+    public $name;
+}
diff --git a/docs/snippets/guide/common-techniques/context_awareness_at.php b/docs/snippets/guide/common-techniques/context_awareness_at.php
new file mode 100644
index 000000000..7cd5c0f06
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/context_awareness_at.php
@@ -0,0 +1,14 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema()]
+class Product
+{
+    /**
+     * The product name,.
+     * @var string
+     */
+    #[OA\Property()]
+    public $name;
+}
diff --git a/docs/snippets/guide/common-techniques/custom_property_an.php b/docs/snippets/guide/common-techniques/custom_property_an.php
new file mode 100644
index 000000000..c19525429
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/custom_property_an.php
@@ -0,0 +1,23 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Info(
+ *     title="Example",
+ *     version="1.0.0",
+ *     x={
+ *         "some-name": "a-value",
+ *         "another": 2,
+ *         "complex-type": {
+ *             "supported": {
+ *                 {"version": "1.0", "level": "baseapi"},
+ *                 {"version": "2.1", "level": "fullapi"},
+ *             }
+ *         }
+ *     }
+ * )
+ */
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/common-techniques/custom_property_at.php b/docs/snippets/guide/common-techniques/custom_property_at.php
new file mode 100644
index 000000000..8410791c9
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/custom_property_at.php
@@ -0,0 +1,21 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Info(
+    title: 'Example',
+    version: '1.0.0',
+    x: [
+        'some-name' => 'a-value',
+        'another' => 2,
+        'complex-type' => [
+            'supported' => [
+                ['version' => '1.0', 'level' => 'baseapi'],
+                ['version' => '2.1', 'level' => 'fullapi'],
+            ],
+        ],
+    ],
+)]
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/common-techniques/enum_as_schema_an.php b/docs/snippets/guide/common-techniques/enum_as_schema_an.php
new file mode 100644
index 000000000..e8b6e3eac
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/enum_as_schema_an.php
@@ -0,0 +1,24 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema()
+ */
+enum Colour
+{
+    case GREEN;
+    case BLUE;
+    case RED;
+}
+
+/**
+ * @OA\Schema
+ */
+class Product
+{
+    /**
+     * @OA\Property
+     */
+    public Colour $colour;
+}
diff --git a/docs/snippets/guide/common-techniques/enum_as_schema_at.php b/docs/snippets/guide/common-techniques/enum_as_schema_at.php
new file mode 100644
index 000000000..8e67fd59f
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/enum_as_schema_at.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema()]
+enum Colour
+{
+    case GREEN;
+    case BLUE;
+    case RED;
+}
+
+#[OA\Schema()]
+class Product
+{
+    #[OA\Property()]
+    public Colour $colour;
+}
diff --git a/docs/snippets/guide/common-techniques/enum_as_values_an.php b/docs/snippets/guide/common-techniques/enum_as_values_an.php
new file mode 100644
index 000000000..e94a11ee9
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/enum_as_values_an.php
@@ -0,0 +1,19 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+enum Suit
+{
+    case Hearts;
+    case Diamonds;
+    case Clubs;
+    case Spades;
+}
+
+class Model
+{
+    /**
+     * @OA\Property(enum={"Suit::Hearts", "Suit::Diamonds"})
+     */
+    protected array $someSuits;
+}
diff --git a/docs/snippets/guide/common-techniques/enum_as_values_at.php b/docs/snippets/guide/common-techniques/enum_as_values_at.php
new file mode 100644
index 000000000..66ab61349
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/enum_as_values_at.php
@@ -0,0 +1,17 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+enum Suit
+{
+    case Hearts;
+    case Diamonds;
+    case Clubs;
+    case Spades;
+}
+
+class Model
+{
+    #[OA\Property(enum: [Suit::Hearts, Suit::Diamonds])]
+    protected array $someSuits;
+}
diff --git a/docs/snippets/guide/common-techniques/explicit_context_an.php b/docs/snippets/guide/common-techniques/explicit_context_an.php
new file mode 100644
index 000000000..43373d6e1
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/explicit_context_an.php
@@ -0,0 +1,21 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema
+ */
+class Product
+{
+    /**
+     * The product name.
+     * @var string
+     *
+     * @OA\Property(
+     *     property="name",
+     *     type="string",
+     *     description="The product name"
+     * )
+     */
+    public $name;
+}
diff --git a/docs/snippets/guide/common-techniques/explicit_context_at.php b/docs/snippets/guide/common-techniques/explicit_context_at.php
new file mode 100644
index 000000000..338bd7885
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/explicit_context_at.php
@@ -0,0 +1,17 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema()]
+class Product
+{
+    /**
+     * The product name.
+     */
+    #[OA\Property(
+        property: 'name',
+        type: 'string',
+        description: 'The product name'
+    )]
+    public string $name;
+}
diff --git a/docs/snippets/guide/common-techniques/response_json_content_an.php b/docs/snippets/guide/common-techniques/response_json_content_an.php
new file mode 100644
index 000000000..4588e7178
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/response_json_content_an.php
@@ -0,0 +1,17 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class Controller
+{
+    /**
+     * @OA\Response(
+     *     response=200,
+     *     description="successful operation",
+     *     @OA\JsonContent(ref="#/components/schemas/User"),
+     * )
+     */
+    public function endpoint()
+    {
+    }
+}
diff --git a/docs/snippets/guide/common-techniques/response_json_content_at.php b/docs/snippets/guide/common-techniques/response_json_content_at.php
new file mode 100644
index 000000000..61756ce1b
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/response_json_content_at.php
@@ -0,0 +1,17 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class Controller
+{
+    #[OA\Response(
+        response: 200,
+        description: 'successful operation',
+        content: new OA\JsonContent(
+            ref: '#/components/schemas/User',
+        ),
+    )]
+    public function endpoint()
+    {
+    }
+}
diff --git a/docs/snippets/guide/common-techniques/response_media_type_an.php b/docs/snippets/guide/common-techniques/response_media_type_an.php
new file mode 100644
index 000000000..388603f4e
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/response_media_type_an.php
@@ -0,0 +1,20 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class Controller
+{
+    /**
+     * @OA\Response(
+     *     response=200,
+     *     description="successful operation",
+     *     @OA\MediaType(
+     *         mediaType="application/json",
+     *         @OA\Schema(ref="#/components/schemas/User"),
+     *     )
+     * ),
+     */
+    public function endpoint()
+    {
+    }
+}
diff --git a/docs/snippets/guide/common-techniques/response_media_type_at.php b/docs/snippets/guide/common-techniques/response_media_type_at.php
new file mode 100644
index 000000000..0f3798a05
--- /dev/null
+++ b/docs/snippets/guide/common-techniques/response_media_type_at.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class Controller
+{
+    #[OA\Response(
+        response: 200,
+        description: 'successful operation',
+        content: new OA\MediaType(
+            mediaType: 'application/json',
+            schema: new OA\Schema(ref: '#/components/schemas/User'),
+        ),
+    )]
+    public function endpoint()
+    {
+    }
+}
diff --git a/docs/snippets/guide/cookbook/class_constants_an.php b/docs/snippets/guide/cookbook/class_constants_an.php
new file mode 100644
index 000000000..1f856cf18
--- /dev/null
+++ b/docs/snippets/guide/cookbook/class_constants_an.php
@@ -0,0 +1,12 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema
+ */
+class Airport
+{
+    /** @OA\Property(property="kind") */
+    public const KIND = 'Airport';
+}
diff --git a/docs/snippets/guide/cookbook/class_constants_at.php b/docs/snippets/guide/cookbook/class_constants_at.php
new file mode 100644
index 000000000..414ad8906
--- /dev/null
+++ b/docs/snippets/guide/cookbook/class_constants_at.php
@@ -0,0 +1,10 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema()]
+class Airport
+{
+    #[OA\Property(property: 'kind')]
+    public const KIND = 'Airport';
+}
diff --git a/docs/snippets/guide/cookbook/default_security_an.php b/docs/snippets/guide/cookbook/default_security_an.php
index 521ed7b0c..375a1af32 100644
--- a/docs/snippets/guide/cookbook/default_security_an.php
+++ b/docs/snippets/guide/cookbook/default_security_an.php
@@ -4,13 +4,13 @@
 
 /**
  * @OA\OpenApi(
- *   security={{"bearerAuth": {}}}
+ *     security={{"bearerAuth": {}}}
  * )
  *
  * @OA\SecurityScheme(
- *   securityScheme="bearerAuth",
- *   type="http",
- *   scheme="bearer"
+ *     securityScheme="bearerAuth",
+ *     type="http",
+ *     scheme="bearer"
  * )
  */
 class OpenApiSpec
diff --git a/docs/snippets/guide/cookbook/default_security_at.php b/docs/snippets/guide/cookbook/default_security_at.php
index fdac07547..9378a621f 100644
--- a/docs/snippets/guide/cookbook/default_security_at.php
+++ b/docs/snippets/guide/cookbook/default_security_at.php
@@ -11,7 +11,7 @@
             securityScheme: 'bearerAuth',
             type: 'http',
             scheme: 'bearer'
-        )
+        ),
     ]
 )]
 class OpenApiSpec
diff --git a/docs/snippets/guide/cookbook/enums_an.php b/docs/snippets/guide/cookbook/enums_an.php
new file mode 100644
index 000000000..6c9f80c27
--- /dev/null
+++ b/docs/snippets/guide/cookbook/enums_an.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/** @OA\Schema() */
+enum State
+{
+    case OPEN;
+    case MERGED;
+    case DECLINED;
+}
+
+/** @OA\Schema */
+class PullRequest
+{
+    /** @OA\Property */
+    public State $state;
+}
diff --git a/docs/snippets/guide/cookbook/enums_at.php b/docs/snippets/guide/cookbook/enums_at.php
new file mode 100644
index 000000000..4f5cf9e92
--- /dev/null
+++ b/docs/snippets/guide/cookbook/enums_at.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema()]
+enum State
+{
+    case OPEN;
+    case MERGED;
+    case DECLINED;
+}
+
+#[OA\Schema()]
+class PullRequest
+{
+    #[OA\Property()]
+    public State $state;
+}
diff --git a/docs/snippets/guide/cookbook/external_documentation_an.php b/docs/snippets/guide/cookbook/external_documentation_an.php
new file mode 100644
index 000000000..22661c30f
--- /dev/null
+++ b/docs/snippets/guide/cookbook/external_documentation_an.php
@@ -0,0 +1,15 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\OpenApi(
+ *     @OA\ExternalDocumentation(
+ *         description="More documentation here...",
+ *         url="https://example.com/externaldoc1/"
+ *     )
+ * )
+ */
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/external_documentation_at.php b/docs/snippets/guide/cookbook/external_documentation_at.php
new file mode 100644
index 000000000..5d78b0d9f
--- /dev/null
+++ b/docs/snippets/guide/cookbook/external_documentation_at.php
@@ -0,0 +1,13 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\OpenApi(
+    externalDocs: new OA\ExternalDocumentation(
+        description: 'More documentation here...',
+        url: 'https://example.com/externaldoc1/',
+    ),
+)]
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/file_upload_with_headers_an.php b/docs/snippets/guide/cookbook/file_upload_with_headers_an.php
new file mode 100644
index 000000000..56b83424d
--- /dev/null
+++ b/docs/snippets/guide/cookbook/file_upload_with_headers_an.php
@@ -0,0 +1,41 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class Controller
+{
+    /**
+     * @OA\Post(
+     *     path="/v1/media/upload",
+     *     summary="Upload document",
+     *     description="",
+     *     tags={"Media"},
+     *     @OA\RequestBody(
+     *         required=true,
+     *         @OA\MediaType(
+     *             mediaType="application/octet-stream",
+     *             @OA\Schema(
+     *                 required={"content"},
+     *                 @OA\Property(
+     *                     description="Binary content of file",
+     *                     property="content",
+     *                     type="string",
+     *                     format="binary"
+     *                 )
+     *             )
+     *         )
+     *     ),
+     *     @OA\Response(
+     *         response=200, description="Success",
+     *         @OA\Schema(type="string")
+     *     ),
+     *     @OA\Response(
+     *         response=400, description="Bad Request"
+     *     )
+     * )
+     */
+    public function upload()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/file_upload_with_headers_at.php b/docs/snippets/guide/cookbook/file_upload_with_headers_at.php
new file mode 100644
index 000000000..e593bc8b2
--- /dev/null
+++ b/docs/snippets/guide/cookbook/file_upload_with_headers_at.php
@@ -0,0 +1,42 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class Controller
+{
+    #[OA\Post(
+        path: '/v1/media/upload',
+        summary: 'Upload document',
+        description: '',
+        tags: ['Media'],
+        requestBody: new OA\RequestBody(
+            required: true,
+            content: new OA\MediaType(
+                mediaType: 'application/octet-stream',
+                schema: new OA\Schema(
+                    required: ['content'],
+                    properties: [
+                        new OA\Property(
+                            description: 'Binary content of file',
+                            property: 'content',
+                            type: 'string',
+                            format: 'binary',
+                        ),
+                    ],
+                ),
+            ),
+        ),
+    )]
+    #[OA\Response(
+        response: 200,
+        description: 'Success',
+    )]
+    #[OA\Response(
+        response: 400,
+        description: 'Bad Request',
+    )]
+    public function upload()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/multi_value_query_parameter_an.php b/docs/snippets/guide/cookbook/multi_value_query_parameter_an.php
new file mode 100644
index 000000000..1c812517b
--- /dev/null
+++ b/docs/snippets/guide/cookbook/multi_value_query_parameter_an.php
@@ -0,0 +1,30 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class Controller
+{
+    /**
+     * @OA\Get(
+     *     path="/api/endpoint",
+     *     description="The endpoint",
+     *     operationId="endpoint",
+     *     tags={"endpoints"},
+     *     @OA\Parameter(
+     *         name="things[]",
+     *         in="query",
+     *         description="A list of things.",
+     *         required=false,
+     *         @OA\Schema(
+     *             type="array",
+     *             @OA\Items(type="integer")
+     *         )
+     *     ),
+     *     @OA\Response(response="200", description="All good")
+     * )
+     */
+    public function endpoint()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/multi_value_query_parameter_at.php b/docs/snippets/guide/cookbook/multi_value_query_parameter_at.php
new file mode 100644
index 000000000..706e1267b
--- /dev/null
+++ b/docs/snippets/guide/cookbook/multi_value_query_parameter_at.php
@@ -0,0 +1,32 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class Controller
+{
+    #[OA\Get(
+        path: '/api/endpoint',
+        description: 'The endpoint',
+        operationId: 'endpoint',
+        tags: ['endpoints'],
+        parameters: [
+            new OA\Parameter(
+                name: 'things[]',
+                in: 'query',
+                description: 'A list of things.',
+                required: false,
+                schema: new OA\Schema(
+                    type: 'array',
+                    items: new OA\Items(type: 'integer')
+                )
+            ),
+        ],
+        responses: [
+            new OA\Response(response: '200', description: 'All good'),
+        ]
+    )]
+    public function endpoint()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/nested_objects_an.php b/docs/snippets/guide/cookbook/nested_objects_an.php
new file mode 100644
index 000000000..ae128ed1e
--- /dev/null
+++ b/docs/snippets/guide/cookbook/nested_objects_an.php
@@ -0,0 +1,38 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema(
+ *     schema="Profile",
+ *     type="object",
+ *
+ *     @OA\Property(
+ *         property="Status",
+ *         type="string",
+ *         example="0"
+ *     ),
+ *
+ *     @OA\Property(
+ *         property="Group",
+ *         type="object",
+ *
+ *         @OA\Property(
+ *             property="ID",
+ *             description="ID de grupo",
+ *             type="number",
+ *             example=-1
+ *         ),
+ *
+ *         @OA\Property(
+ *             property="Name",
+ *             description="Nombre de grupo",
+ *             type="string",
+ *             example="Superadmin"
+ *         )
+ *     )
+ * )
+ */
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/nested_objects_at.php b/docs/snippets/guide/cookbook/nested_objects_at.php
new file mode 100644
index 000000000..e0c9fca92
--- /dev/null
+++ b/docs/snippets/guide/cookbook/nested_objects_at.php
@@ -0,0 +1,36 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'Profile',
+    type: 'object',
+    properties: [
+        new OA\Property(
+            property: 'Status',
+            type: 'string',
+            example: '0',
+        ),
+        new OA\Property(
+            property: 'Group',
+            type: 'object',
+            properties: [
+                new OA\Property(
+                    property: 'ID',
+                    description: 'ID de grupo',
+                    type: 'number',
+                    example: -1,
+                ),
+                new OA\Property(
+                    property: 'Name',
+                    description: 'Nombre de grupo',
+                    type: 'string',
+                    example: 'Superadmin'
+                ),
+            ],
+        ),
+    ],
+)]
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/oneof_example_an.php b/docs/snippets/guide/cookbook/oneof_example_an.php
new file mode 100644
index 000000000..5e369bfef
--- /dev/null
+++ b/docs/snippets/guide/cookbook/oneof_example_an.php
@@ -0,0 +1,25 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class Controller
+{
+    /**
+     * @OA\Response(
+     *     response=200,
+     *     @OA\JsonContent(
+     *         oneOf={
+     *             @OA\Schema(ref="#/components/schemas/QualificationHolder"),
+     *             @OA\Schema(
+     *                 type="array",
+     *                 @OA\Items(ref="#/components/schemas/QualificationHolder")
+     *             )
+     *         }
+     *     )
+     * )
+     */
+    public function index()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/oneof_example_at.php b/docs/snippets/guide/cookbook/oneof_example_at.php
new file mode 100644
index 000000000..96accbb4c
--- /dev/null
+++ b/docs/snippets/guide/cookbook/oneof_example_at.php
@@ -0,0 +1,23 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class Controller
+{
+    #[OA\Response(
+        response: 200,
+        content: new OA\JsonContent(
+            oneOf: [
+                new OA\Schema(ref: '#/components/schemas/QualificationHolder'),
+                new OA\Schema(
+                    type: 'array',
+                    items: new OA\Items(ref: '#/components/schemas/QualificationHolder')
+                ),
+            ],
+        ),
+    )]
+    public function index()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/properties_with_union_types_an.php b/docs/snippets/guide/cookbook/properties_with_union_types_an.php
new file mode 100644
index 000000000..c5a815e0c
--- /dev/null
+++ b/docs/snippets/guide/cookbook/properties_with_union_types_an.php
@@ -0,0 +1,29 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema(
+ *     schema="StringList",
+ *     @OA\Property(property="value", type="array", @OA\Items(anyOf={@OA\Schema(type="string")}))
+ * )
+ * @OA\Schema(
+ *     schema="String",
+ *     @OA\Property(property="value", type="string")
+ * )
+ * @OA\Schema(
+ *     schema="Object",
+ *     @OA\Property(property="value", type="object")
+ * )
+ * @OA\Schema(
+ *     schema="mixedList",
+ *     @OA\Property(property="fields", type="array", @OA\Items(oneOf={
+ *         @OA\Schema(ref="#/components/schemas/StringList"),
+ *         @OA\Schema(ref="#/components/schemas/String"),
+ *         @OA\Schema(ref="#/components/schemas/Object")
+ *     }))
+ * )
+ */
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/properties_with_union_types_at.php b/docs/snippets/guide/cookbook/properties_with_union_types_at.php
new file mode 100644
index 000000000..10acc5e58
--- /dev/null
+++ b/docs/snippets/guide/cookbook/properties_with_union_types_at.php
@@ -0,0 +1,53 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'StringList',
+    properties: [
+        new OA\Property(
+            property: 'value',
+            type: 'array',
+            items: new OA\Items(
+                anyOf: [new OA\Schema(type: 'string')]
+            ),
+        ),
+    ],
+)]
+#[OA\Schema(
+    schema: 'String',
+    properties: [
+        new OA\Property(
+            property: 'value',
+            type: 'string',
+        ),
+],
+)]
+#[OA\Schema(
+    schema: 'Object',
+    properties: [
+        new OA\Property(
+            property: 'value',
+            type: 'object',
+        ),
+],
+)]
+#[OA\Schema(
+    schema: 'mixedList',
+    properties: [
+        new OA\Property(
+            property: 'fields',
+            type: 'array',
+            items: new OA\Items(
+                oneOf: [
+                    new OA\Schema(ref: '#/components/schemas/StringList'),
+                    new OA\Schema(ref: '#/components/schemas/String'),
+                    new OA\Schema(ref: '#/components/schemas/Object'),
+                ],
+            ),
+        ),
+    ],
+)]
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/response_examples_an.php b/docs/snippets/guide/cookbook/response_examples_an.php
new file mode 100644
index 000000000..ef0ff4aab
--- /dev/null
+++ b/docs/snippets/guide/cookbook/response_examples_an.php
@@ -0,0 +1,31 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class Controller
+{
+    /**
+     * @OA\Schema(
+     *     schema="Result",
+     *     type="object",
+     *     properties={
+     *         @OA\Property(property="success", type="boolean"),
+     *     },
+     * )
+     * @OA\Response(
+     *     response=200,
+     *     description="OK",
+     *     @OA\JsonContent(
+     *         oneOf={
+     *             @OA\Schema(ref="#/components/schemas/Result"),
+     *             @OA\Schema(type="boolean")
+     *         },
+     *         @OA\Examples(example="result", value={"success": true}, summary="An result object."),
+     *         @OA\Examples(example="bool", value=false, summary="A boolean value."),
+     *     )
+     * )
+     */
+    public function operation()
+    {
+    }
+}
diff --git a/docs/snippets/guide/cookbook/response_examples_at.php b/docs/snippets/guide/cookbook/response_examples_at.php
new file mode 100644
index 000000000..c356b2a4d
--- /dev/null
+++ b/docs/snippets/guide/cookbook/response_examples_at.php
@@ -0,0 +1,31 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class Controller
+{
+    #[OA\Schema(
+        schema: 'Result',
+        type: 'object',
+        properties: [
+            new OA\Property(property: 'success', type: 'boolean'),
+        ],
+    )]
+    #[OA\Response(
+        response: 200,
+        description: 'OK',
+        content: new OA\JsonContent(
+            oneOf: [
+                new OA\Schema(ref: '#/components/schemas/Result'),
+                new OA\Schema(type: 'boolean'),
+            ],
+            examples: [
+                new OA\Examples(example: 'result', value: ['success' => true], summary: 'An result object.'),
+                new OA\Examples(example: 'bool', value: false, summary: 'A boolean value.'),
+            ],
+        ),
+    )]
+    public function operation()
+    {
+    }
+}
diff --git a/docs/snippets/guide/cookbook/reusing_response_an.php b/docs/snippets/guide/cookbook/reusing_response_an.php
new file mode 100644
index 000000000..aa865272a
--- /dev/null
+++ b/docs/snippets/guide/cookbook/reusing_response_an.php
@@ -0,0 +1,33 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Response(
+ *     response="product",
+ *     description="All information about a product",
+ *     @OA\JsonContent(ref="#/components/schemas/Product")
+ * )
+ */
+class ProductResponse
+{
+}
+
+// ...
+
+class ProductController
+{
+    /**
+     * @OA\Get(
+     *     tags={"Products"},
+     *     path="/products/{product_id}",
+     *     @OA\Response(
+     *         response="default",
+     *         ref="#/components/responses/product"
+     *     )
+     * )
+     */
+    public function getProduct($id)
+    {
+    }
+}
diff --git a/docs/snippets/guide/cookbook/reusing_response_at.php b/docs/snippets/guide/cookbook/reusing_response_at.php
new file mode 100644
index 000000000..e4b45a37d
--- /dev/null
+++ b/docs/snippets/guide/cookbook/reusing_response_at.php
@@ -0,0 +1,31 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Response(
+    response: 'product',
+    description: 'All information about a product',
+    content: new OA\JsonContent(ref: '#/components/schemas/Product'),
+)]
+class ProductResponse
+{
+}
+
+// ...
+
+class ProductController
+{
+    #[OA\Get(
+        tags: ['Products'],
+        path: '/products/{product_id}',
+        responses: [
+            new OA\Response(
+                response: 'default',
+                ref: '#/components/responses/product'
+            ),
+        ],
+    )]
+    public function getProduct($id)
+    {
+    }
+}
diff --git a/docs/snippets/guide/cookbook/secure_endpoint_an.php b/docs/snippets/guide/cookbook/secure_endpoint_an.php
new file mode 100644
index 000000000..f50ddf363
--- /dev/null
+++ b/docs/snippets/guide/cookbook/secure_endpoint_an.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class Controller
+{
+    /**
+     * @OA\Get(
+     *     path="/api/secure/",
+     *     summary="Requires authentication",
+     *     security={ {"api_key": {}} }
+     * )
+     */
+    public function getSecurely()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/secure_endpoint_at.php b/docs/snippets/guide/cookbook/secure_endpoint_at.php
new file mode 100644
index 000000000..7a44a54a7
--- /dev/null
+++ b/docs/snippets/guide/cookbook/secure_endpoint_at.php
@@ -0,0 +1,20 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class Controller
+{
+    #[OA\Get(
+        path: '/api/secure/',
+        summary: 'Requires authentication',
+        security: [
+            [
+                'api_key' => [],
+            ],
+        ],
+    )]
+    public function getSecurely()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/security_schema_tips_an.php b/docs/snippets/guide/cookbook/security_schema_tips_an.php
new file mode 100644
index 000000000..5dc90b410
--- /dev/null
+++ b/docs/snippets/guide/cookbook/security_schema_tips_an.php
@@ -0,0 +1,20 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class Controller
+{
+    /**
+     * @OA\Get(
+     *     path="/api/secure/",
+     *     summary="Requires authentication",
+     *     security={
+     *         { "api_key": {} },
+     *         { "petstore_auth": {"write:pets", "read:pets"} }
+     *     }
+     * )
+     */
+    public function secure()
+    {
+    }
+}
diff --git a/docs/snippets/guide/cookbook/security_schema_tips_at.php b/docs/snippets/guide/cookbook/security_schema_tips_at.php
new file mode 100644
index 000000000..dd9c836e8
--- /dev/null
+++ b/docs/snippets/guide/cookbook/security_schema_tips_at.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class Controller
+{
+    #[OA\Get(
+        path: '/api/secure/',
+        summary: 'Requires authentication',
+        security: [
+            ['api_key' => []],
+            ['petstore_auth' => ['write:pets', 'read:pets']],
+        ]
+    )]
+    public function secure()
+    {
+    }
+}
diff --git a/docs/snippets/guide/cookbook/security_schemas_an.php b/docs/snippets/guide/cookbook/security_schemas_an.php
new file mode 100644
index 000000000..d61d14552
--- /dev/null
+++ b/docs/snippets/guide/cookbook/security_schemas_an.php
@@ -0,0 +1,28 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\SecurityScheme(
+ *     type="apiKey",
+ *     name="api_key",
+ *     in="header",
+ *     securityScheme="api_key"
+ * )
+ *
+ * @OA\SecurityScheme(
+ *     type="oauth2",
+ *     securityScheme="petstore_auth",
+ *     @OA\Flow(
+ *         authorizationUrl="http://petstore.swagger.io/oauth/dialog",
+ *         flow="implicit",
+ *         scopes={
+ *             "read:pets": "read your pets",
+ *             "write:pets": "modify pets in your account"
+ *         }
+ *     )
+ * )
+ */
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/security_schemas_at.php b/docs/snippets/guide/cookbook/security_schemas_at.php
new file mode 100644
index 000000000..1f21aa84a
--- /dev/null
+++ b/docs/snippets/guide/cookbook/security_schemas_at.php
@@ -0,0 +1,27 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\SecurityScheme(
+    type: 'apiKey',
+    name: 'api_key',
+    in: 'header',
+    securityScheme: 'api_key',
+)]
+#[OA\SecurityScheme(
+    type: 'oauth2',
+    securityScheme: 'petstore_auth',
+    flows: [
+        new OA\Flow(
+            authorizationUrl: 'http://petstore.swagger.io/oauth/dialog',
+            flow: 'implicit',
+            scopes: [
+                'read:pets' => 'read your pets',
+                'write:pets' => 'modify pets in your account',
+            ],
+        ),
+    ],
+)]
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/set_xml_root_name_an.php b/docs/snippets/guide/cookbook/set_xml_root_name_an.php
new file mode 100644
index 000000000..b2b126d4d
--- /dev/null
+++ b/docs/snippets/guide/cookbook/set_xml_root_name_an.php
@@ -0,0 +1,24 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema(
+ *     schema="Error",
+ *     @OA\Property(property="message"),
+ *     @OA\Xml(name="details")
+ * )
+ * @OA\Post(
+ *     path="/foobar",
+ *     @OA\Response(
+ *         response=400,
+ *         description="Request error",
+ *         @OA\XmlContent(ref="#/components/schemas/Error",
+ *             @OA\Xml(name="error")
+ *         )
+ *     )
+ * )
+ */
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/set_xml_root_name_at.php b/docs/snippets/guide/cookbook/set_xml_root_name_at.php
new file mode 100644
index 000000000..e9138f797
--- /dev/null
+++ b/docs/snippets/guide/cookbook/set_xml_root_name_at.php
@@ -0,0 +1,25 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    schema: 'Error',
+    properties: [new OA\Property(property: 'message')],
+    xml: new OA\Xml(name: 'details'),
+)]
+#[OA\Post(
+    path: '/foobar',
+    responses: [
+        new OA\Response(
+            response: 400,
+            description: 'Request error',
+            content: new OA\XmlContent(
+                ref: '#/components/schemas/Error',
+                xml: new OA\Xml(name: 'error'),
+            ),
+        ),
+    ],
+)]
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/uploading_multipart_formdata_an.php b/docs/snippets/guide/cookbook/uploading_multipart_formdata_an.php
new file mode 100644
index 000000000..e78f62fb7
--- /dev/null
+++ b/docs/snippets/guide/cookbook/uploading_multipart_formdata_an.php
@@ -0,0 +1,32 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+class OpenApiSpec
+{
+    /**
+     * @OA\Post(
+     *     path="/v1/user/update",
+     *     summary="Form post",
+     *     @OA\RequestBody(
+     *         @OA\MediaType(
+     *             mediaType="multipart/form-data",
+     *             @OA\Schema(
+     *                 @OA\Property(property="name"),
+     *                 @OA\Property(
+     *                     description="file to upload",
+     *                     property="avatar",
+     *                     type="string",
+     *                     format="binary",
+     *                 ),
+     *             )
+     *         )
+     *     ),
+     *     @OA\Response(response=200, description="Success")
+     * )
+     */
+    public function update()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/uploading_multipart_formdata_at.php b/docs/snippets/guide/cookbook/uploading_multipart_formdata_at.php
new file mode 100644
index 000000000..b15af2cbf
--- /dev/null
+++ b/docs/snippets/guide/cookbook/uploading_multipart_formdata_at.php
@@ -0,0 +1,37 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+class OpenApiSpec
+{
+    #[OA\Post(
+        path: '/v1/user/update',
+        summary: 'Form post',
+        requestBody: new OA\RequestBody(
+            content: new OA\MediaType(
+                mediaType: 'multipart/form-data',
+                schema: new OA\Schema(
+                    properties: [
+                        new OA\Property(
+                            property: 'name',
+                        ),
+                        new OA\Property(
+                            description: 'file to upload',
+                            property: 'avatar',
+                            type: 'string',
+                            format: 'binary',
+                        ),
+                    ],
+                ),
+            ),
+        ),
+    )]
+    #[OA\Response(
+        response: 200,
+        description: 'Success'
+    )]
+    public function update()
+    {
+        // ...
+    }
+}
diff --git a/docs/snippets/guide/cookbook/virtual_model_an.php b/docs/snippets/guide/cookbook/virtual_model_an.php
new file mode 100644
index 000000000..ee7690747
--- /dev/null
+++ b/docs/snippets/guide/cookbook/virtual_model_an.php
@@ -0,0 +1,19 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Schema(
+ *     @OA\Property(
+ *         property="name",
+ *         type="string",
+ *     ),
+ *     @OA\Property(
+ *         property="email",
+ *         type="string",
+ *     ),
+ * )
+ */
+class User
+{
+}
diff --git a/docs/snippets/guide/cookbook/virtual_model_at.php b/docs/snippets/guide/cookbook/virtual_model_at.php
new file mode 100644
index 000000000..f6769d909
--- /dev/null
+++ b/docs/snippets/guide/cookbook/virtual_model_at.php
@@ -0,0 +1,13 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Schema(
+    properties: [
+        'name' => new OA\Property(property: 'name', type: 'string'),
+        'email' => new OA\Property(property: 'email', type: 'string'),
+    ]
+)]
+class User
+{
+}
diff --git a/docs/snippets/guide/cookbook/x_tag_groups_an.php b/docs/snippets/guide/cookbook/x_tag_groups_an.php
new file mode 100644
index 000000000..ce5c01526
--- /dev/null
+++ b/docs/snippets/guide/cookbook/x_tag_groups_an.php
@@ -0,0 +1,15 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\OpenApi(
+ *     x={
+ *         "tagGroups": {{"name": "User Management", "tags": {"Users", "API keys", "Admin"}}
+ *         }
+ *     }
+ * )
+ */
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/cookbook/x_tag_groups_at.php b/docs/snippets/guide/cookbook/x_tag_groups_at.php
new file mode 100644
index 000000000..037614eed
--- /dev/null
+++ b/docs/snippets/guide/cookbook/x_tag_groups_at.php
@@ -0,0 +1,14 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\OpenApi(
+    x: [
+        'tagGroups' => [
+            ['name' => 'User Management', 'tags' => ['Users', 'API keys', 'Admin']],
+        ],
+    ]
+)]
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/faq/dummy_class_an.php b/docs/snippets/guide/faq/dummy_class_an.php
new file mode 100644
index 000000000..fc66eef90
--- /dev/null
+++ b/docs/snippets/guide/faq/dummy_class_an.php
@@ -0,0 +1,23 @@
+<?php
+
+use OpenApi\Annotations as OA;
+
+/**
+ * @OA\Tag(
+ *     name="user",
+ *     description="User related operations"
+ * )
+ * @OA\Info(
+ *     version="1.0",
+ *     title="Example API",
+ *     description="Example info",
+ *     @OA\Contact(name="Swagger API Team")
+ * )
+ * @OA\Server(
+ *     url="https://example.localhost",
+ *     description="API server"
+ * )
+ */
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/guide/faq/dummy_class_at.php b/docs/snippets/guide/faq/dummy_class_at.php
new file mode 100644
index 000000000..87e0fcc7b
--- /dev/null
+++ b/docs/snippets/guide/faq/dummy_class_at.php
@@ -0,0 +1,18 @@
+<?php
+
+use OpenApi\Attributes as OA;
+
+#[OA\Tag(name: 'user', description: 'User related operations')]
+#[OA\Info(
+    version: '1.0',
+    title: 'Example API',
+    description: 'Example info',
+    contact: new OA\Contact(name: 'Swagger API Team'),
+)]
+#[OA\Server(
+    url: 'https://example.localhost',
+    description: 'API server',
+)]
+class OpenApiSpec
+{
+}
diff --git a/docs/snippets/minimal_api_an.php b/docs/snippets/minimal_api_an.php
index 5094d366b..e774dd169 100644
--- a/docs/snippets/minimal_api_an.php
+++ b/docs/snippets/minimal_api_an.php
@@ -14,7 +14,6 @@ class OpenApi
 
 class MyController
 {
-
     /**
      * @OA\Get(
      *     path="/api/data.json",
diff --git a/docs/snippets/minimal_api_at.php b/docs/snippets/minimal_api_at.php
index bb788f5b1..1a95f7647 100644
--- a/docs/snippets/minimal_api_at.php
+++ b/docs/snippets/minimal_api_at.php
@@ -2,14 +2,13 @@
 
 use OpenApi\Attributes as OA;
 
-#[OA\Info(title: "My First API", version: "0.1")]
+#[OA\Info(title: 'My First API', version: '0.1')]
 class OpenApi
 {
 }
 
 class MyController
 {
-
     #[OA\Get(path: '/api/data.json', operationId: 'getData')]
     #[OA\Response(response: '200', description: 'The data')]
     public function getResource()