Skip to content

Commit 29f1c60

Browse files
committed
docs: reorganize AsyncAPI and OpenAPI documentation structure for clarity
1 parent 890a6bc commit 29f1c60

9 files changed

Lines changed: 14 additions & 28 deletions

File tree

website/docs/codegen/CLI/asyncapi/_category_.json

Lines changed: 0 additions & 10 deletions
This file was deleted.

website/docs/codegen/CLI/cli.mdx

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,7 @@ sidebar_label: CLI overview
99

1010
It supports **two generation modes**:
1111

12-
- **[OpenAPI mode](/codegen/CLI/openapi.mdx)** (`qraft openapi`) — generates code from OpenAPI documents with OpenAPI plugins.
13-
- **[AsyncAPI mode](/codegen/CLI/asyncapi/index.mdx)** (`qraft asyncapi`) — enables generation from AsyncAPI documents with AsyncAPI plugins.
12+
- **[OpenAPI mode](/codegen/openapi/index.mdx)** (`qraft openapi`) — generates code from OpenAPI documents with OpenAPI plugins.
13+
- **[AsyncAPI mode](/codegen/asyncapi/index.mdx)** (`qraft asyncapi`) — enables generation from AsyncAPI documents with AsyncAPI plugins.
1414

1515
This lets you use one CLI package and one binary (`qraft`) for both OpenAPI and AsyncAPI schemas.
16-
17-
## Detailed docs
18-
19-
- [OpenAPI mode (`qraft openapi`)](/codegen/CLI/openapi.mdx)
20-
- [AsyncAPI mode (`qraft asyncapi`)](/codegen/CLI/asyncapi/index.mdx)
21-
- [Redocly config support](/codegen/CLI/redocly-config.mdx)

website/docs/codegen/CLI/openapi/_category_.json

Lines changed: 0 additions & 10 deletions
This file was deleted.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"label": "AsyncAPI",
3+
"position": 3,
4+
"collapsible": false,
5+
"collapsed": false
6+
}
File renamed without changes.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"label": "OpenAPI",
3+
"position": 2,
4+
"collapsible": false,
5+
"collapsed": false
6+
}

website/docs/codegen/CLI/openapi/create-api-client-function.mdx renamed to website/docs/codegen/openapi/create-api-client-function.mdx

File renamed without changes.

website/docs/codegen/CLI/openapi/create-predefined-parameters-request-fn.mdx renamed to website/docs/codegen/openapi/create-predefined-parameters-request-fn.mdx

File renamed without changes.

0 commit comments

Comments
 (0)