Prepare release v5.0.1 (#1425)

Author: sserrata

CHANGELOG.md

@@ -1,3 +1,44 @@
+## 5.0.1 (2026-04-14)
+
+Patch release with a new scaffolding CLI, performance improvements, compatibility fixes for Docusaurus 3.10.0 strict admonition syntax, and a security fix for axios CVEs.
+
+#### :rocket: New Feature
+
+- feat: add create-docusaurus-openapi-docs CLI package ([#1413](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1413))
+
+#### :bug: Bug Fix
+
+- Fix deprecation notice for Docusaurus 3.10.0 strict admonition syntax ([#1423](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1423))
+- fix: rename experimental_faster to faster, remove --ignore from canary ([#1415](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1415))
+- fix: update axios resolution to ^1.15.0 to address critical CVEs
+
+#### :running_woman: Performance
+
+- perf: use Clipboard API ([#1416](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1416))
+
+#### :robot: Dependencies
+
+- chore(deps): bump follow-redirects from 1.15.11 to 1.16.0 ([#1424](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1424))
+- chore(deps): bump unist-util-visit from 5.0.0 to 5.1.0 ([#1422](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1422))
+- chore(deps): bump commander from 12.1.0 to 14.0.3 ([#1421](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1421))
+- chore(deps): bump react-hook-form from 7.72.0 to 7.72.1 ([#1409](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1409))
+
+#### :wrench: Maintenance
+
+- chore(deps-dev): bump @typescript-eslint/eslint-plugin ([#1419](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1419))
+- chore(deps-dev): bump eslint-plugin-cypress from 2.15.2 to 3.6.0 ([#1420](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1420))
+- chore(deps-dev): bump nodemon from 2.0.22 to 3.1.14 ([#1408](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1408))
+- chore(deps-dev): bump @types/lodash from 4.17.23 to 4.17.24 ([#1406](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1406))
+- chore(deps-dev): bump lint-staged from 11.2.6 to 16.4.0 ([#1411](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1411))
+- chore(deps-dev): bump eslint-plugin-testing-library from 6.5.0 to 7.16.2 ([#1410](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/pull/1410))
+
+#### Committers: 4
+
+- dependabot[bot]
+- Florian Lefebvre
+- Ollie Monk
+- Steven Serrata
+
 ## 5.0.0 (2026-04-08)
 
 **Breaking Change:** Minimum Docusaurus version is now `3.10.0`. Users on Docusaurus 3.5–3.9 must upgrade before updating to this release.

demo/docs/intro.mdx

@@ -85,34 +85,31 @@ Other ReDoc specific extensions such as `x-circular-ref`, `x-code-samples` (depr
 
 
 :::tip
-If you're building a Docusaurus site from scratch, the easiest way to get started is by [installing from template](#bootstrapping-from-template-new-docusaurus-site).
+If you're building a Docusaurus site from scratch, the easiest way to get started is with the [Quick Start](#quick-start-new-docusaurus-site) CLI.
 :::
 
-## Bootstrapping from Template (new Docusaurus site)
+## Quick Start (new Docusaurus site)
 
 Run the following to bootstrap a Docusaurus v3 site (classic theme) with `docusaurus-openapi-docs`:
 
 ```bash
-npx create-docusaurus@3.10.0 my-website --package-manager yarn
+npx create-docusaurus-openapi-docs my-website
 ```
 
-> When prompted to select a template choose `Git repository`.
-
-Template Repository URL:
-
-```bash
-https://github.com/PaloAltoNetworks/docusaurus-template-openapi-docs.git
-```
-
-> When asked how the template repo should be cloned choose "copy" (unless you know better).
-
 ```bash
 cd my-website
 yarn start
 ```
 
 If all goes well, you should be greeted by a brand new Docusaurus site that includes API reference docs for the ubiquitous Petstore API!
 
+### CLI Options
+
+| Option                            | Description                                           |
+| --------------------------------- | ----------------------------------------------------- |
+| `-p, --package-manager <manager>` | Use a specific package manager (yarn, npm, pnpm, bun) |
+| `-s, --skip-install`              | Skip automatic dependency installation                |
+
 ## Installation (existing Docusaurus site)
 
 :::note

lerna.json

@@ -1,4 +1,4 @@
 {
-  "version": "5.0.0",
+  "version": "5.0.1",
   "npmClient": "yarn"
 }

packages/create-docusaurus-openapi-docs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-docusaurus-openapi-docs",
   "description": "Create Docusaurus sites with OpenAPI docs.",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "license": "MIT",
   "keywords": [
     "openapi",

packages/create-docusaurus-openapi-docs/templates/default/package.json

@@ -23,8 +23,8 @@
     "@docusaurus/preset-classic": "3.10.0",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
-    "docusaurus-plugin-openapi-docs": "PLACEHOLDER",
-    "docusaurus-theme-openapi-docs": "PLACEHOLDER",
+    "docusaurus-plugin-openapi-docs": "5.0.1",
+    "docusaurus-theme-openapi-docs": "5.0.1",
     "prism-react-renderer": "^2.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

packages/docusaurus-plugin-openapi-docs/README.md

@@ -47,31 +47,28 @@ Key Features:
 | 2.2.3 (end-of-support)  | `2.4.1 - 2.4.3` |
 | 1.7.3 (end-of-support)  | `2.0.1 - 2.2.0` |
 
-## Bootstrapping from Template (new Docusaurus site)
+## Quick Start (new Docusaurus site)
 
 Run the following to bootstrap a Docusaurus v3 site (classic theme) with `docusaurus-openapi-docs`:
 
 ```bash
-npx create-docusaurus@3.10.0 my-website --package-manager yarn
+npx create-docusaurus-openapi-docs my-website
 ```
 
-> When prompted to select a template choose `Git repository`.
-
-Template Repository URL:
-
-```bash
-https://github.com/PaloAltoNetworks/docusaurus-template-openapi-docs.git
-```
-
-> When asked how the template repo should be cloned choose "copy".
-
 ```bash
 cd my-website
 yarn start
 ```
 
 If all goes well, you should be greeted by a brand new Docusaurus site that includes API reference docs for the ubiquitous Petstore API!
 
+### CLI Options
+
+| Option                            | Description                                           |
+| --------------------------------- | ----------------------------------------------------- |
+| `-p, --package-manager <manager>` | Use a specific package manager (yarn, npm, pnpm, bun) |
+| `-s, --skip-install`              | Skip automatic dependency installation                |
+
 ## Installation (existing Docusaurus site)
 
 > Both the plugin and theme are currently designed to pair with a specific Docusaurus release. The Docusaurus badge in the `README.md` and at the top of this page will always reflect the current compatible versions.

packages/docusaurus-plugin-openapi-docs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-plugin-openapi-docs",
   "description": "OpenAPI plugin for Docusaurus.",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "license": "MIT",
   "keywords": [
     "openapi",

packages/docusaurus-theme-openapi-docs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docusaurus-theme-openapi-docs",
   "description": "OpenAPI theme for Docusaurus.",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "license": "MIT",
   "keywords": [
     "openapi",
@@ -38,7 +38,7 @@
     "@types/postman-collection": "^3.5.11",
     "@types/react-modal": "^3.16.3",
     "concurrently": "^9.2.0",
-    "docusaurus-plugin-openapi-docs": "^5.0.0",
+    "docusaurus-plugin-openapi-docs": "^5.0.1",
     "docusaurus-plugin-sass": "^0.2.6",
     "eslint-plugin-prettier": "^5.5.1"
   },