Skip to content

docs: rewrite documentation to be leaner and user-focused#83

Closed
michaelbe812 wants to merge 1 commit intomainfrom
feat/lean-docs
Closed

docs: rewrite documentation to be leaner and user-focused#83
michaelbe812 wants to merge 1 commit intomainfrom
feat/lean-docs

Conversation

@michaelbe812
Copy link
Copy Markdown
Contributor

Summary

  • Consolidated 14 doc pages into 8, reducing overall content from ~4300 lines to ~530 lines
  • Made it immediately obvious that @nx-plugin-openapi/core + a generator plugin (plugin-openapi or plugin-hey-api) is the recommended approach
  • Legacy package clearly marked as legacy with a concise migration guide
  • Landing page updated to be generator-agnostic (no longer Angular-focused)

Changes

  • Getting started: merged overview + installation + quick-start into single page
  • Removed: plugins/overview, usage/configuration, usage/examples, usage/nx-integration, reference/generate-api
  • Added: reference/configuration (lean options table)
  • Trimmed: plugin pages, creating-plugins guide, legacy overview
  • Updated: all 4 package READMEs, root README, landing page, sidebar

Test plan

  • Verify docs site builds (nx build docs)
  • Check all internal links resolve correctly
  • Review each page for completeness and clarity

🤖 Generated with Claude Code

Consolidate 14 doc pages into 8. Reduce overall doc content from ~4600
lines to ~340 lines. Make it immediately obvious that @nx-plugin-openapi/core
with a generator plugin (plugin-openapi or plugin-hey-api) is the
recommended approach. Legacy package clearly marked with migration guide.

- Merge getting-started (overview + installation + quick-start) into single page
- Remove plugins/overview, usage/configuration, usage/examples, usage/nx-integration
- Remove exhaustive reference/generate-api (replaced by lean configuration reference)
- Trim plugin pages to essentials
- Trim creating-plugins guide
- Update landing page tagline and cards to be generator-agnostic
- Update sidebar to match new structure
- Rewrite all package READMEs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@michaelbe812 michaelbe812 deleted the feat/lean-docs branch April 2, 2026 14:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant