From 0a324eb337c48a1b6744173fb7ed543ea3b6c31c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 6 Dec 2025 00:04:25 +0000 Subject: [PATCH 1/7] Update installation.mdx --- installation.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/installation.mdx b/installation.mdx index a3a2c405f..89d02fd1a 100644 --- a/installation.mdx +++ b/installation.mdx @@ -77,6 +77,16 @@ For example, if you have a group named `admin`, you can preview as a member of t mint dev --groups admin ``` +### Skip OpenAPI processing + +If you have many OpenAPI files in your documentation, you can skip OpenAPI file processing during local development to improve performance by using the `--disable-openapi` flag: + +```bash +mint dev --disable-openapi +``` + +This flag skips rendering OpenAPI schemas, which can significantly speed up the local development experience for projects with a large number of OpenAPI files. + ## Create a new project To create a new documentation project, run the following command: From 749096033d372dea653747b6cfe5d3e932436ac6 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 6 Dec 2025 00:34:10 +0000 Subject: [PATCH 2/7] Update installation.mdx --- installation.mdx | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/installation.mdx b/installation.mdx index 89d02fd1a..a3a2c405f 100644 --- a/installation.mdx +++ b/installation.mdx @@ -77,16 +77,6 @@ For example, if you have a group named `admin`, you can preview as a member of t mint dev --groups admin ``` -### Skip OpenAPI processing - -If you have many OpenAPI files in your documentation, you can skip OpenAPI file processing during local development to improve performance by using the `--disable-openapi` flag: - -```bash -mint dev --disable-openapi -``` - -This flag skips rendering OpenAPI schemas, which can significantly speed up the local development experience for projects with a large number of OpenAPI files. - ## Create a new project To create a new documentation project, run the following command: From dbcc0eeb65e4e838ffc9ae1f04f29401fd67ffb5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 6 Dec 2025 00:34:13 +0000 Subject: [PATCH 3/7] Update api-playground/openapi-setup.mdx --- api-playground/openapi-setup.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index 978a715ce..b3f176961 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -6,6 +6,16 @@ keywords: ["OpenAPI", "API specification", "Swagger"] OpenAPI is a specification for describing APIs. Mintlify supports OpenAPI 3.0+ documents to generate interactive API documentation and keep it up to date. +## Skip OpenAPI processing during local development + +If you have many OpenAPI files in your documentation, you can skip OpenAPI file processing during local development to improve performance by using the `--disable-openapi` flag: + +```bash +mint dev --disable-openapi +``` + +This flag skips rendering OpenAPI schemas, which can significantly speed up the local development experience for projects with a large number of OpenAPI files. + ## Add an OpenAPI specification file To document your endpoints with OpenAPI, you need a valid OpenAPI specification in either JSON or YAML format that follows the [OpenAPI specification 3.0+](https://swagger.io/specification/). From a7f52c2dc341d9fe072ddd032f8ae05285ad22b8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 6 Dec 2025 00:36:49 +0000 Subject: [PATCH 4/7] Update api-playground/openapi-setup.mdx --- api-playground/openapi-setup.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index b3f176961..1b30cba1b 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -8,14 +8,12 @@ OpenAPI is a specification for describing APIs. Mintlify supports OpenAPI 3.0+ d ## Skip OpenAPI processing during local development -If you have many OpenAPI files in your documentation, you can skip OpenAPI file processing during local development to improve performance by using the `--disable-openapi` flag: +Skip OpenAPI file processing during local development by using the `--disable-openapi` flag: ```bash mint dev --disable-openapi ``` -This flag skips rendering OpenAPI schemas, which can significantly speed up the local development experience for projects with a large number of OpenAPI files. - ## Add an OpenAPI specification file To document your endpoints with OpenAPI, you need a valid OpenAPI specification in either JSON or YAML format that follows the [OpenAPI specification 3.0+](https://swagger.io/specification/). From b17cb00d26c9a478f60e1ffa622e4c74c9de708c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 6 Dec 2025 00:39:58 +0000 Subject: [PATCH 5/7] Update api-playground/openapi-setup.mdx --- api-playground/openapi-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index 1b30cba1b..ff040ed62 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -8,7 +8,7 @@ OpenAPI is a specification for describing APIs. Mintlify supports OpenAPI 3.0+ d ## Skip OpenAPI processing during local development -Skip OpenAPI file processing during local development by using the `--disable-openapi` flag: +If you have many OpenAPI files, skip OpenAPI file processing during local development to improve performance by using the `--disable-openapi` flag: ```bash mint dev --disable-openapi From 5f809c4dc0c67ac17723fce22c4138a5476567d3 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 5 Dec 2025 16:49:08 -0800 Subject: [PATCH 6/7] move info to CLI page --- api-playground/openapi-setup.mdx | 8 -------- installation.mdx | 8 ++++++++ 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index ff040ed62..978a715ce 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -6,14 +6,6 @@ keywords: ["OpenAPI", "API specification", "Swagger"] OpenAPI is a specification for describing APIs. Mintlify supports OpenAPI 3.0+ documents to generate interactive API documentation and keep it up to date. -## Skip OpenAPI processing during local development - -If you have many OpenAPI files, skip OpenAPI file processing during local development to improve performance by using the `--disable-openapi` flag: - -```bash -mint dev --disable-openapi -``` - ## Add an OpenAPI specification file To document your endpoints with OpenAPI, you need a valid OpenAPI specification in either JSON or YAML format that follows the [OpenAPI specification 3.0+](https://swagger.io/specification/). diff --git a/installation.mdx b/installation.mdx index a3a2c405f..920196f7a 100644 --- a/installation.mdx +++ b/installation.mdx @@ -67,6 +67,14 @@ If you attempt to run on a port that is already in use, it will use the next ava Port 3000 is already in use. Trying 3001 instead. ``` +## Skip OpenAPI processing during local development + +If you have many OpenAPI files, skip OpenAPI file processing during local development to improve performance by using the `--disable-openapi` flag: + +```bash +mint dev --disable-openapi +``` + ### Preview as a specific group If you use partial authentication to restrict access to your documentation, you can preview as a specific authentication group by using the `--groups [groupname]` flag. From 33bfef69ebf91e6b579a35db1b32d123cfdfda3a Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 5 Dec 2025 16:49:38 -0800 Subject: [PATCH 7/7] copyedit --- installation.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installation.mdx b/installation.mdx index 920196f7a..e1d9a06da 100644 --- a/installation.mdx +++ b/installation.mdx @@ -67,7 +67,7 @@ If you attempt to run on a port that is already in use, it will use the next ava Port 3000 is already in use. Trying 3001 instead. ``` -## Skip OpenAPI processing during local development +## Skip OpenAPI processing If you have many OpenAPI files, skip OpenAPI file processing during local development to improve performance by using the `--disable-openapi` flag: