Switch annotation/attribute tab order to make showing attributes the …

…default (#1587)

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>

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>

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>

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>

docs/snippets/guide/cookbook/default_security_an.php

@@ -13,6 +13,6 @@
  *   scheme="bearer"
  * )
  */
-class OpenApi
+class OpenApiSpec
 {
 }

docs/snippets/minimal_api_at.php

@@ -17,7 +17,3 @@ public function getResource()
         // ...
     }
 }
-
-class OpenApiSpec
-{
-}