docs: move legacy plugin to own section and update landing page

- Move @lambda-solutions/nx-plugin-openapi docs to dedicated
  "Legacy Nx Plugin" top-level section
- Update landing page to highlight plugin system:
  - Replace "Flexible Configuration" with "Extensible Plugin System"
  - Add plugin architecture to features list
- Update plugins overview to reference new legacy section location
- Remove legacy plugin from plugins section (now standalone)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: michaelbe812

apps/docs/astro.config.mjs

@@ -32,7 +32,6 @@ export default defineConfig({
             { label: 'Overview', slug: 'plugins/overview' },
             { label: 'OpenAPI Generator', slug: 'plugins/plugin-openapi' },
             { label: 'hey-api', slug: 'plugins/plugin-hey-api' },
-            { label: '@lambda-solutions/nx-plugin-openapi', slug: 'plugins/legacy-plugin' },
           ],
         },
         {
@@ -55,6 +54,12 @@ export default defineConfig({
             { label: 'Creating Custom Plugins', slug: 'guides/creating-plugins' },
           ],
         },
+        {
+          label: 'Legacy Nx Plugin',
+          items: [
+            { label: 'Overview', slug: 'legacy-nx-plugin/overview' },
+          ],
+        },
         {
           label: 'Roadmap',
           items: [{ label: 'Roadmap', slug: 'roadmap/roadmap' }],

apps/docs/src/content/docs/index.mdx

@@ -34,8 +34,8 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 	<Card title="⚡ Powerful Caching" icon="lightning">
 		Leverages Nx's intelligent caching to avoid regenerating unchanged API clients.
 	</Card>
-	<Card title="🔧 Flexible Configuration" icon="setting">
-		Supports all OpenAPI Generator options with TypeScript-safe configuration.
+	<Card title="🔧 Extensible Plugin System" icon="setting">
+		Choose from multiple code generators or create your own custom plugins.
 	</Card>
 	<Card title="📦 TypeScript-Angular Ready" icon="puzzle">
 		Generates Angular-compatible TypeScript clients out of the box using the well established <a href="https://openapi-generator.tech/docs/generators/typescript-angular">OpenAPI Generator for Angular.</a>
@@ -45,8 +45,8 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 ## Features
 
 - **🎯 Executor-based**: Use `nx run my-app:generate-api` to generate API clients
+- **🔌 Plugin Architecture**: Choose between [OpenAPI Generator](/plugins/plugin-openapi/) or [hey-api](/plugins/plugin-hey-api/), or [create your own](/guides/creating-plugins/)
 - **📁 File & URL Support**: Work with local OpenAPI specs or remote URLs
-- **⚙️ Extensive Configuration**: Support for 30+ OpenAPI Generator options
 - **🔄 Smart Caching**: Only regenerates when OpenAPI specs change
 
 ## Quick Example

…rc/content/docs/plugins/legacy-plugin.md …ontent/docs/legacy-nx-plugin/overview.mdapps/docs/src/content/docs/plugins/legacy-plugin.md renamed to apps/docs/src/content/docs/legacy-nx-plugin/overview.md apps/docs/src/content/docs/plugins/legacy-plugin.md renamed to apps/docs/src/content/docs/legacy-nx-plugin/overview.md

@@ -13,7 +13,10 @@ The Nx Plugin OpenAPI ecosystem provides a modular plugin architecture, allowing
 |--------|---------|-----------------|-------------|
 | [OpenAPI Generator](/plugins/plugin-openapi/) | `@nx-plugin-openapi/plugin-openapi` | `openapi-tools` | Uses the battle-tested [OpenAPI Generator](https://openapi-generator.tech) |
 | [hey-api](/plugins/plugin-hey-api/) | `@nx-plugin-openapi/plugin-hey-api` | `hey-api` | Uses [hey-api/openapi-ts](https://github.com/hey-api/openapi-ts) for modern TypeScript clients |
-| [Legacy Plugin](/plugins/legacy-plugin/) | `@lambda-solutions/nx-plugin-openapi` | N/A (standalone) | Original standalone plugin for OpenAPI Generator |
+
+:::note[Legacy Package]
+Looking for the original `@lambda-solutions/nx-plugin-openapi` package? See the [Legacy Nx Plugin](/legacy-nx-plugin/overview/) section.
+:::
 
 ## Architecture
 
@@ -66,18 +69,6 @@ The plugin system is built around a core package that provides:
 - Plugin-based architecture for customization
 - Modern ESM output
 
-### Legacy Plugin (`@lambda-solutions/nx-plugin-openapi`)
-
-**Best for:**
-- Existing projects already using this plugin
-- Teams who want a single-package solution
-- Angular projects with simpler requirements
-
-**Features:**
-- All-in-one package (no separate core/plugin)
-- Dedicated executor for OpenAPI Generator
-- Same Nx integration features
-
 ## Using Multiple Generators
 
 You can use different generators for different projects in your monorepo:
@@ -120,4 +111,4 @@ Need to integrate a different OpenAPI generator? The plugin architecture makes i
 
 - [OpenAPI Generator Plugin](/plugins/plugin-openapi/) - Full documentation for the OpenAPI Generator plugin
 - [hey-api Plugin](/plugins/plugin-hey-api/) - Full documentation for the hey-api plugin
-- [Legacy Plugin](/plugins/legacy-plugin/) - Documentation for the original standalone plugin
+- [Creating Custom Plugins](/guides/creating-plugins/) - Build your own generator plugin