diff --git a/editor/pages.mdx b/editor/pages.mdx
index dde35205d..5fb5997be 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 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 inline. To update a spec file, upload a replacement file in the web editor or edit it using your preferred code editor and push the changes to your documentation repository.
 </Note>
 
 <Frame>
diff --git a/editor/publish.mdx b/editor/publish.mdx
index d32caed34..ff3bd7f30 100644
--- a/editor/publish.mdx
+++ b/editor/publish.mdx
@@ -35,7 +35,7 @@ As you edit, the editor tracks your changes.
 - New or deleted files.
 - Content edits in pages.
 - Navigation structure changes.
-- Media uploads and organization.
+- Media and file uploads, including API specification files.
 - Configuration updates.
 
 When you work on your deployment branch, changes automatically save.