Merge branch 'main' into agent-docs

Author: ethanpalm

.locadex/LOCADEX.md

@@ -0,0 +1,23 @@
+# 🌐 Locadex Mintlify i18n
+
+This Mintlify documentation site is configured to use Locadex for automated internationalization.
+
+## Configuration:
+
+- **Working Directory**: `.`
+- **Branch Prefix**: `locadex/`
+- **Default Locale**: `en`
+- **Target Locales**: `en`, `fr`, `es`, `zh`
+- **Hide Default Locale**: Enabled
+- **Route Example**: `/docs`
+
+## How it works:
+
+- Once this setup PR is merged, Locadex will automatically monitor your repository for changes
+- Locadex will analyze your Mintlify docs for translatable content and internationalize your changes in your configured locales
+- You can configure when Locadex should run (PRs or commits) and whether it should create PRs or commit directly through the General Translation Dashboard
+
+---
+
+Generated by [Locadex](https://generaltranslation.com) • [Documentation](https://generaltranslation.com/docs)
+Timestamp: 9/17/2025

.vale.ini

@@ -23,9 +23,16 @@ Vale.Avoid = NO # Too aggressive about common technical terms
 TokenIgnores = (?sm)((?:import|export) .+?$), \
 (?<!`)(<\w+ ?.+ ?\/>)(?!`), \
 (<[A-Z]\w+>.+?<\/[A-Z]\w+>), \
-(<[^>]*>)
+(<[^>]*>), \
+\{[^}]*\}, \
+(`[^`]*`), \
+(```[\s\S]*?```)
 
 BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
-(?sm)^({.+.*})
+(?sm)^({.+.*})$, \
+(?sm)^```[\s\S]*?```$
 
-CommentDelimiters = {/*, */}
+CommentDelimiters = {/*, */}
+
+[changelog.mdx]
+BasedOnStyles =

.vale/styles/config/vocabularies/Mintlify/accept.txt

@@ -3,12 +3,14 @@
 # =============================================================================
 # MINTLIFY-SPECIFIC TERMS
 # =============================================================================
+APISection
 autoplay
 bearerAuth
 borderRadius
 camelCase
 discoverability
 (?i)callouts?
+CTAs
 drilldown
 expandables
 favicon
@@ -17,9 +19,11 @@ isHidden
 (?i)modetoggle
 myName
 myObject
+navbar
 onboarding
 (?i)openapi
 repo
+Ronan
 topbar
 (?i)tooltips?
 url
@@ -40,6 +44,7 @@ CircleCI
 Clearbit
 Ctrl
 Cypress
+Docusaurus
 Django
 DynamoDB
 Elasticsearch
@@ -76,6 +81,7 @@ Mocha
 MongoDB
 MySQL
 Next.js
+nginx
 Node.js
 NodeJS
 npx
@@ -115,6 +121,7 @@ Webflow
 WebKit
 (?i)webpack
 WebStorm
+Windsurf's
 Zapier
 
 # =============================================================================
@@ -123,21 +130,22 @@ Zapier
 agentic
 allowlist
 APIs
+API's
 args
 async
-autogenerated
-autogenerating
+autogenerat(e|ed|ing)?
 await
 bool
 boolean
 Blockquote
 Blockquotes
 cdn
 cli
+CNAME
+cpu
 config
 const
 cors
-CNAME
 csrf
 css
 ctx
@@ -171,6 +179,7 @@ lang
 len
 localhost
 md
+(?i)Memoize
 middleware
 Multiline
 mvc
@@ -186,6 +195,7 @@ orm
 params
 pnpm
 png
+prefill(ing|ed)?
 prepend
 prepended
 prev
@@ -234,8 +244,9 @@ ux
 val
 var
 vars
+waypoints
 webhook
-websocket
+websockets?
 xhr
 xhr2
 yaml

analytics/feedback.mdx

@@ -60,7 +60,7 @@ Best practices for setting feedback statuses:
 
 ### Filtering by status
 
-Use the status filter to control which feedback is displayed. Uncheck a status to hide all feedback with that status. By default, all feedback is displayed.
+Use the status filter to control which feedback is displayed. Clear a status to hide all feedback with that status. By default, all feedback is displayed.
 
 ### Adding internal notes
 

api-playground/openapi-setup.mdx

@@ -508,6 +508,24 @@ openapi-schema: "schema-key"
 
 </CodeGroup>
 
+If you have schemas with the same name in multiple files, you can also specify the OpenAPI file:
+
+<CodeGroup>
+
+```mdx Example
+---
+openapi-schema: en-schema.json OrderItem
+---
+```
+
+```mdx Format
+---
+openapi-schema: "path-to-schema-file schema-key"
+---
+```
+
+</CodeGroup>
+
 ## Webhooks
 
 Webhooks are HTTP callbacks that your API sends to notify external systems when events occur. Webhooks are supported in OpenAPI 3.1+ documents.

api-playground/overview.mdx

@@ -25,7 +25,7 @@ We recommend generating your API playground from an OpenAPI specification. See [
     Make sure that your OpenAPI specification file is valid using the [Swagger Editor](https://editor.swagger.io/) or [Mint CLI](https://www.npmjs.com/package/mint).
     </Info>
 
-    ```bash {2}
+    ```bash {3}
     /your-project
       |- docs.json
       |- openapi.json

authentication-personalization/overview.mdx

@@ -27,7 +27,6 @@ Choose from three approaches to manage access and customize your documentation b
 
 **Choose partial authentication when:**
 - Offering public getting-started guides with private advanced features
-- Running a freemium product where premium users get additional documentation
 - Publishing open-source docs with private enterprise sections
 
 **Choose personalization when:**

changelog.mdx

@@ -5,6 +5,32 @@ rss: true
 noindex: true
 ---
 
+<Update label="September 20 - September 26" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Language support expansion, UI improvements, and infrastructure enhancements" }}>
+
+## Language support expansion
+
+- Added support for Romanian and Czech languages in the documentation interface
+- Enhanced localization capabilities with complete translation coverage for new languages
+- Improved language selector functionality across all themes
+
+## UI and user experience improvements
+
+- Fixed tab visibility issues on 404 pages to prevent incorrect active tab highlighting
+- Enhanced image handling with proper width and height attribute passing for non-optimized images
+- Improved 404 page layout and styling consistency
+
+## Infrastructure and performance enhancements
+
+- Enhanced GIF image processing by skipping costly Imgix auto-formatting to reduce processing time and bandwidth usage
+- Optimized image serving performance with special handling for animated content
+
+## Bug fixes and reliability
+
+- Fixed contact email routing in dashboard settings for Assistant add-on requests
+- Enhanced database schema updates for better user management
+
+</Update>
+
 <Update label="September 14 - September 19" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "GitLab integration enhancements, app router migration progress, authentication improvements, and bug fixes" }}>
 
 ## GitLab integration enhancements

components/files.mdx

@@ -0,0 +1,29 @@
+---
+title: "Files"
+description: "Serve static assets from your documentation"
+icon: "folder"
+---
+
+Mintlify automatically serves static assets from your documentation repository at the appropriate path on your domain. For example, if you have `/images/my-logo.png` in your repo, the image file is available at `https://docs.your-project.com/images/my-logo.png`.
+
+This works for any file type you want to make available to your users, including images, PDFs, videos, or schemas.
+
+Files must be less than 20 MB for images and 100 MB for other file types.
+
+## File organization
+
+Organize your files using folders to keep your repository easy to navigate:
+
+```text
+/your-project
+  |- docs.json
+  |- images/
+    |- logo.png
+    |- screenshots/
+      |- dashboard.png
+  |- assets/
+    |- whitepaper.pdf
+    |- demo-video.mp4
+```
+
+Files are served from the root of your domain, so the structure in your repository directly maps to the URL structure. From the previous example, `assets/whitepaper.pdf` would be available at `https://docs.your-project.com/assets/whitepaper.pdf`.

contact-support.mdx

@@ -16,7 +16,7 @@ Visit our [YouTube](https://www.youtube.com/@GetMintlify/videos) channel for tut
 
 Send us a message from your [dashboard](https://dashboard.mintlify.com/) by selecting **Support** in the sidebar.
 
-![Gif showing how to access support from the dashboard by selecting the Support button, then selecting an option and typing a question in the support modal that pops up.](https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/support-flow.gif)
+![GIF showing how to access support from the dashboard by selecting the Support button, then selecting an option and typing a question in the support modal that pops up.](https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/support-flow.gif)
 
 <Info>
 We aim to respond to all requests within 24 hours, but delays may occur during busy times.