docs: reorganize and simplify CLI documentation structure for better navigation

Author: radist2s

website/docs/codegen/CLI/asyncapi-cli.mdx website/docs/codegen/CLI/asyncapi.mdxwebsite/docs/codegen/CLI/asyncapi-cli.mdx renamed to website/docs/codegen/CLI/asyncapi.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_position: 3
-sidebar_label: AsyncAPI CLI
+sidebar_label: AsyncAPI
 ---
 
 # AsyncAPI mode (`qraft asyncapi`)
@@ -19,7 +19,7 @@ npm install -D @qraft/cli @qraft/asyncapi-typescript-plugin
 
 ## Usage
 
-```bash
+```bash npm2yarn
 npx qraft asyncapi --plugin asyncapi-typescript ./asyncapi.yaml --output-dir src/events
 ```
 
@@ -29,9 +29,9 @@ npx qraft asyncapi --plugin asyncapi-typescript ./asyncapi.yaml --output-dir src
 
 ## Plugin selection
 
-Unlike legacy CLI flows where defaults could be implied, `qraft asyncapi` requires explicit plugin selection:
+`qraft asyncapi` requires explicit plugin selection:
 
-```bash
+```bash npm2yarn
 npx qraft asyncapi --plugin asyncapi-typescript ./asyncapi.yaml -o ./src/events
 ```
 
@@ -52,14 +52,8 @@ apis:
 
 Then run:
 
-```bash
+```bash npm2yarn
 npx qraft asyncapi --redocly
 # or generate both OpenAPI + AsyncAPI entries
 npx qraft redocly
 ```
-
-## Notes on compatibility
-
-- Existing OpenAPI generation remains available through `qraft openapi`.
-- Existing OpenAPI plugins continue to work in OpenAPI mode.
-- AsyncAPI plugins are additive and can coexist in the same project with OpenAPI plugins.

website/docs/codegen/CLI/cli.mdx

@@ -9,39 +9,10 @@ sidebar_label: CLI overview
 
 It supports **two generation modes**:
 
-- **OpenAPI mode** (`qraft openapi`) — keeps the existing OpenAPI generation flow and existing OpenAPI plugins.
-- **AsyncAPI mode** (`qraft asyncapi`) — enables generation from AsyncAPI documents with AsyncAPI plugins.
+- **[OpenAPI mode](/codegen/CLI/openapi-cli.mdx)** (`qraft openapi`) — generates code from OpenAPI documents with OpenAPI plugins.
+- **[AsyncAPI mode](/codegen/CLI/asyncapi-cli.mdx)** (`qraft asyncapi`) — enables generation from AsyncAPI documents with AsyncAPI plugins.
 
-This lets you use one CLI package and one binary (`qraft`) for both REST/OpenAPI and event-driven/AsyncAPI schemas.
-
-## Installation
-
-```bash npm2yarn
-npm install -D @qraft/cli
-```
-
-Install plugins depending on your use case:
-
-```bash npm2yarn
-# OpenAPI plugins
-npm install -D @openapi-qraft/tanstack-query-react-plugin @openapi-qraft/openapi-typescript-plugin
-
-# AsyncAPI plugin
-npm install -D @qraft/asyncapi-typescript-plugin
-```
-
-## Quick examples
-
-```bash
-# OpenAPI generation
-npx qraft openapi --plugin tanstack-query-react --plugin openapi-typescript ./openapi.yaml -o ./src/api
-
-# AsyncAPI generation
-npx qraft asyncapi --plugin asyncapi-typescript ./asyncapi.yaml -o ./src/events
-
-# Generate from redocly.yaml (both x-openapi-qraft + x-asyncapi-qraft)
-npx qraft redocly
-```
+This lets you use one CLI package and one binary (`qraft`) for both OpenAPI and AsyncAPI schemas.
 
 ## Detailed docs
 

website/docs/codegen/CLI/openapi-cli.mdx website/docs/codegen/CLI/openapi.mdxwebsite/docs/codegen/CLI/openapi-cli.mdx renamed to website/docs/codegen/CLI/openapi.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_position: 2
-sidebar_label: OpenAPI CLI
+sidebar_label: OpenAPI
 ---
 
 import Tabs from '@theme/Tabs';
@@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem';
 # OpenAPI mode (`qraft openapi`)
 
 `qraft openapi` is the OpenAPI-focused mode of the unified `@qraft/cli` package.
-It generates API schemas and interfaces for `@openapi-qraft/react` and keeps the existing OpenAPI generation flow fully compatible.
+It generates code from OpenAPI documents using OpenAPI plugins, including React services and TypeScript schema types.
 
 Qraft relies on types from the generation result of [`openapi-typescript`](https://www.npmjs.com/package/openapi-typescript) package,
 which is a powerful tool for generating types from an OpenAPI schema.

website/docs/codegen/CLI/redocly-config.mdx

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 3
 sidebar_label: Redocly config support
 ---