From e5b3b3ae6620d3e5d9ea289f364b373e4d0c929f Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 26 Mar 2026 18:11:48 +0000
Subject: [PATCH 1/2] Document read-only API spec files in web editor

Generated-By: mintlify-agent
---
 editor/pages.mdx | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/editor/pages.mdx b/editor/pages.mdx
index 3e6549c93..e4f73b647 100644
--- a/editor/pages.mdx
+++ b/editor/pages.mdx
@@ -27,6 +27,10 @@ Browse your documentation pages in the **Navigation** tab of the left panel.
 
 Switch between visual and Markdown mode with the toggle in the toolbar. The web editor saves your changes when switching modes.
 
+<Note>
+  API specification files (OpenAPI and AsyncAPI) are read-only in the web editor. You can view their contents but cannot edit them directly. To update a spec file, edit it in your repository using your preferred code editor and push the changes to your documentation repository.
+</Note>
+
 <Frame>
   <img
     src="/images/editor/mode-toggle-light.png"

From 9cef3616061c048a8effc632ddfe0aa7b555165e Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Tue, 31 Mar 2026 16:31:15 -0700
Subject: [PATCH 2/2] Apply suggestion from @ethanpalm

---
 editor/pages.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/editor/pages.mdx b/editor/pages.mdx
index e4f73b647..746f33a69 100644
--- a/editor/pages.mdx
+++ b/editor/pages.mdx
@@ -28,7 +28,7 @@ Browse your documentation pages in the **Navigation** tab of the left panel.
 Switch between visual and Markdown mode with the toggle in the toolbar. The web editor saves your changes when switching modes.
 
 <Note>
-  API specification files (OpenAPI and AsyncAPI) are read-only in the web editor. You can view their contents but cannot edit them directly. To update a spec file, edit it in your repository using your preferred code editor and push the changes to your documentation repository.
+  API specification files (OpenAPI and AsyncAPI) are read-only in the web editor. You can view their contents but cannot edit them directly. To update a spec file, edit it using your preferred code editor and push the changes to your documentation repository.
 </Note>
 
 <Frame>