diff --git a/docs/.vitepress/theme/components/Codeblock.vue b/docs/.vitepress/theme/components/Codeblock.vue
index bec5d06e0..0e7b13162 100644
--- a/docs/.vitepress/theme/components/Codeblock.vue
+++ b/docs/.vitepress/theme/components/Codeblock.vue
@@ -1,12 +1,12 @@
-
-
-
+
+
+
diff --git a/docs/guide/cookbook.md b/docs/guide/cookbook.md
index 8c3b26fe8..cd722a95b 100644
--- a/docs/guide/cookbook.md
+++ b/docs/guide/cookbook.md
@@ -278,17 +278,17 @@ Form posts are `@OA\Post` requests with a `multipart/form-data` `@OA\RequestBody
Unless specified each endpoint needs to declare what security schemes it supports. However, there is a way
to also configure security schemes globally for the whole API.
-This is done on the `@OA\OpenApi` annotations:
+This is done on the `@OA\OpenApi` annotation:
-
+
-<<< @/snippets/guide/cookbook/default_security_an.php
+<<< @/snippets/guide/cookbook/default_security_at.php
-
+
-<<< @/snippets/guide/cookbook/default_security_at.php
+<<< @/snippets/guide/cookbook/default_security_an.php
diff --git a/docs/guide/required-elements.md b/docs/guide/required-elements.md
index c82097914..7918f3bb2 100644
--- a/docs/guide/required-elements.md
+++ b/docs/guide/required-elements.md
@@ -9,17 +9,17 @@ The endpoint, in turn, needs to have a path and at least one response.
## Minimum required annotations
-With the above in mind a minimal API with a single endpoint could look like this
+With the above in mind a minimal API with a single endpoint could look like this:
-
+
-<<< @/snippets/minimal_api_an.php
+<<< @/snippets/minimal_api_at.php
-
+
-<<< @/snippets/minimal_api_at.php
+<<< @/snippets/minimal_api_an.php
diff --git a/docs/index.md b/docs/index.md
index d9142f839..e84a4cbe0 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -20,17 +20,17 @@ features:
### 2. Update your code
-Add `swagger-php` annotations or attributes to your source code.
+Add `swagger-php` attributes or annotations to your source code.
-
+
-<<< @/snippets/minimal_api_an.php
+<<< @/snippets/minimal_api_at.php
-
+
-<<< @/snippets/minimal_api_at.php
+<<< @/snippets/minimal_api_an.php
diff --git a/docs/snippets/example_annotations.php b/docs/snippets/example_annotations.php
deleted file mode 100644
index 2772d36d2..000000000
--- a/docs/snippets/example_annotations.php
+++ /dev/null
@@ -1,21 +0,0 @@
-