From d7a9c21878e1fc90a4eaec762ca22d289ef8b52e Mon Sep 17 00:00:00 2001
From: Martin Rademacher <mano@radebatz.net>
Date: Thu, 2 May 2024 16:11:26 +1200
Subject: [PATCH] Switch annotation/attribute tab order to make showing
 attributes the default (#1587)

---
 .../.vitepress/theme/components/Codeblock.vue |  6 +++---
 docs/guide/cookbook.md                        | 10 ++++-----
 docs/guide/required-elements.md               | 10 ++++-----
 docs/index.md                                 | 10 ++++-----
 docs/snippets/example_annotations.php         | 21 -------------------
 .../guide/cookbook/default_security_an.php    |  2 +-
 docs/snippets/minimal_api_at.php              |  4 ----
 7 files changed, 19 insertions(+), 44 deletions(-)
 delete mode 100644 docs/snippets/example_annotations.php

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 @@
 <template>
   <div>
     <tabs :options="{ useUrlFragment: false }">
-      <tab :id="anId" name="Annotations">
-        <slot name="an"></slot>
-      </tab>
       <tab :id="atId" name="Attributes">
         <slot name="at"></slot>
       </tab>
+      <tab :id="anId" name="Annotations">
+        <slot name="an"></slot>
+      </tab>
     </tabs>
   </div>
 </template>
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:
 
 <codeblock id="minimal">
-  <template v-slot:an>
+  <template v-slot:at>
 
-<<< @/snippets/guide/cookbook/default_security_an.php
+<<< @/snippets/guide/cookbook/default_security_at.php
 
   </template>
-  <template v-slot:at>
+  <template v-slot:an>
 
-<<< @/snippets/guide/cookbook/default_security_at.php
+<<< @/snippets/guide/cookbook/default_security_an.php
 
   </template>
 </codeblock>
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:
 
 <codeblock id="minimal">
-  <template v-slot:an>
+  <template v-slot:at>
 
-<<< @/snippets/minimal_api_an.php
+<<< @/snippets/minimal_api_at.php
 
   </template>
-  <template v-slot:at>
+  <template v-slot:an>
 
-<<< @/snippets/minimal_api_at.php
+<<< @/snippets/minimal_api_an.php
 
   </template>
 </codeblock>
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.
 
 <codeblock id="minimal">
-  <template v-slot:an>
+  <template v-slot:at>
 
-<<< @/snippets/minimal_api_an.php
+<<< @/snippets/minimal_api_at.php
 
   </template>
-  <template v-slot:at>
+  <template v-slot:an>
 
-<<< @/snippets/minimal_api_at.php
+<<< @/snippets/minimal_api_an.php
 
   </template>
 </codeblock>
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 @@
-<?php
-
-use OpenApi\Annotations as OA;
-
-/**
- * @OA\Info(title="My First API", version="0.1")
- */
-class OpenApi {}
-
-class MyController {
-
-    /**
-     * @OA\Get(
-     *     path="/api/resource.json",
-     *     @OA\Response(response="200", description="An example resource")
-     * )
-     */
-    public function resource() {
-        // ...
-    }
-}
diff --git a/docs/snippets/guide/cookbook/default_security_an.php b/docs/snippets/guide/cookbook/default_security_an.php
index ac0140efd..521ed7b0c 100644
--- a/docs/snippets/guide/cookbook/default_security_an.php
+++ b/docs/snippets/guide/cookbook/default_security_an.php
@@ -13,6 +13,6 @@
  *   scheme="bearer"
  * )
  */
-class OpenApi
+class OpenApiSpec
 {
 }
diff --git a/docs/snippets/minimal_api_at.php b/docs/snippets/minimal_api_at.php
index cc4fc4825..2706c8d71 100644
--- a/docs/snippets/minimal_api_at.php
+++ b/docs/snippets/minimal_api_at.php
@@ -17,7 +17,3 @@ public function getResource()
         // ...
     }
 }
-
-class OpenApiSpec
-{
-}