feat(openapi-metadata): complete rewrite

Author: kerwanp

docs/.vitepress/en.ts

@@ -75,8 +75,14 @@ export default defineConfig({
             { text: "Getting Started", link: "/openapi-react-query/" },
             { text: "useQuery", link: "/openapi-react-query/use-query" },
             { text: "useMutation", link: "/openapi-react-query/use-mutation" },
-            { text: "useSuspenseQuery", link: "/openapi-react-query/use-suspense-query" },
-            { text: "queryOptions", link: "/openapi-react-query/query-options" },
+            {
+              text: "useSuspenseQuery",
+              link: "/openapi-react-query/use-suspense-query",
+            },
+            {
+              text: "queryOptions",
+              link: "/openapi-react-query/query-options",
+            },
             { text: "About", link: "/openapi-react-query/about" },
           ],
         },
@@ -94,10 +100,15 @@ export default defineConfig({
           ],
         },
         {
-          text: "openapi-decorators",
+          text: "openapi-metadata",
           items: [
-            { text: "Getting Started", link: "/openapi-decorators/" },
-            { text: "Decorators", link: "/openapi-decorators/decorators" },
+            { text: "Getting Started", link: "/openapi-metadata/" },
+            { text: "Decorators", link: "/openapi-metadata/decorators" },
+            { text: "Metadata", link: "/openapi-metadata/metadata" },
+            { text: "Type loader", link: "/openapi-metadata/type-loader" },
+            { text: "UI Integrations", link: "/openapi-metadata/ui" },
+            { text: "Examples", link: "/openapi-metadata/examples" },
+            { text: "About", link: "/openapi-metadata/about" },
           ],
         },
       ],
@@ -110,6 +121,12 @@ export default defineConfig({
         indexName: "openapi-ts",
       },
     },
+    socialLinks: [
+      {
+        icon: "github",
+        link: "https://github.com/openapi-ts/openapi-typescript",
+      },
+    ],
     footer: {
       message:
         'Released under the <a href="https://github.com/openapi-ts/openapi-typescript/blob/main/packages/openapi-typescript/LICENSE">MIT License</a>.',

docs/data/contributors.json

@@ -0,0 +1,23 @@
+---
+title: About openapi-metadata
+description: openapi-metadata Project Goals, comparisons, and more
+---
+
+<script setup>
+  import { VPTeamMembers } from 'vitepress/theme';
+  import contributors from '../data/contributors.json';
+</script>
+
+# About
+
+## Project Goals
+
+1. Must respect the OpenAPI V3 specification
+2. Be extensible and easily integrated inside backend frameworks
+3. Be focused around developer experience
+
+## Contributors
+
+This library wouldn’t be possible without all these amazing contributors:
+
+<VPTeamMembers size="small" :members="contributors['openapi-metadata']" />

docs/openapi-adonis/decorators.md

@@ -0,0 +1,25 @@
+---
+title: Decorators
+---
+
+# Decorators
+
+Decorators are used to enrich your OpenAPI specifications. They can be applied on a Controller, a Method or a Model. They are all prefixed with `Api`.
+
+> For more information about the decorators, you can directly refer to the [source code](https://github.com/openapi-ts/openapi-typescript/packages/openapi-metadata/src/decorators).
+
+| Decorator               | Usage               | Description                                                              |
+| ----------------------- | ------------------- | ------------------------------------------------------------------------ |
+| `@ApiBody`              | Method              | Sets the requestBody of the operation.                                   |
+| `@ApiCookie`            | Controller / Method | Adds a cookie parameter to the operation(s).                             |
+| `@ApiExcludeController` | Method              | Excludes the operations of this controller from the document generation. |
+| `@ApiExcludeOperation`  | Method              | Excludes this operation from the document generation.                    |
+| `@ApiExtraModels`       | Controller          | Adds extra models to be loaded in the schema.                            |
+| `@ApiHeader`            | Controller / Method | Adds a header parameter to the operation(s).                             |
+| `@ApiOperation`         | Method              | Configures an operation.                                                 |
+| `@ApiParam`             | Controller / Method | Adds a path parameter to the operation(s).                               |
+| `@ApiProperty`          | Model               | Configures a schema property property.                                   |
+| `@ApiQuery`             | Controller / Method | Adds a query parameter to the operation(s).                              |
+| `@ApiResponse`          | Controller / Method | Adds a response to the operation(s).                                     |
+| `@ApiSecurity`          | Controller / Method | Sets the security scheme to the operation(s).                            |
+| `@ApiTags`              | Controller / Method | Adds tags to the operation(s).                                           |