181 Commits

Author SHA1 Message Date
Justin Torre 07c49f67d5 Add self-host deployment doc (#6723)
* Add self-host deployment doc

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Address validation warnings, add platform logos, reframe features table

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* One more style fix

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Fix wordmark logos in platform table, remove unused SVGs, address remaining Vale warnings

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Apply suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Mayank Shouche <43075711+mayankshouche@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-07-24 10:23:24 -07:00
Ethan Palm a4f36e3a8f updates from docs report (#6613) 2026-07-16 11:38:13 -07:00
Ethan Palm 1e4bea0006 Editor comments suggestions (#6605)
* add comments

* add suggestions

* update index

* Update docs.json
2026-07-16 10:24:41 -07:00
Ethan Palm 1e2955559b Analytics UI update (#6596)
* update analytics page

* update feedback page
2026-07-15 18:14:58 -07:00
Ethan Palm dd1c14da9c editor drafts copy edits (#6534)
* 💅

* Apply suggestion from @ethanpalm
2026-07-13 17:18:36 -07:00
mintlify[bot] 1112868720 docs: update contact support page with new image and instructions (#6516)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-13 10:29:30 -07:00
Ethan Palm be7a1371ac Custom domain updates (#6465)
* docs: update custom domain setup for new dashboard flow

Reflect the new custom domain UI: hosting mode selector (domain/subdomain
vs subpath), traffic routing options (Mintlify-managed vs proxy-only),
arbitrary base paths with reserved-path list, and base path changes that
redeploy with rollback on failure. Replace references to the removed
Host at /docs toggle in the Vercel and reverse proxy guides.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* copy edit

* update images

* docs: update subpath proxy guides for dashboard base paths

Custom subpaths no longer require documentation files to live in a
directory matching the subpath. The base path set in the dashboard is
applied at build time, so the custom subpath reverse proxy setup now
uses the same routing configuration as /docs with the path substituted.
Add dashboard base path setup steps to the Vercel, Cloudflare Worker,
and Route 53/CloudFront guides.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* 💅

* add plan gate

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* update vercel generator

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* remove gate

* remove gate

* Fix review findings: shared subpath setup snippet, generalize /docs framing, clarify Host header and script guidance

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Align hosting mode and traffic routing labels with dashboard UI, update screenshot alt text

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Fix root-only special file routing: path-preserving nginx destinations, restore sitemap/robots/mcp rewrites, sanitize generator input

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Add apex domain DNS provider requirements

Apex domains get the same CNAME instruction as subdomains, but a CNAME
at the apex requires provider support for CNAME flattening or ALIAS
records. Document the requirement and supported providers, and link to
it from the hosting mode section.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Correct special-file routing to base-path destinations per live verification, remove stale toggle images, generalize propagation snippet

Verified against mintlify.mintlify.site: all special files (sitemap.xml,
robots.txt, mcp, skill.md, llms.txt) serve under the base path and 404 at
root, so root-mapping rewrites are reverted and optional root routes now
proxy to base-path destinations. Broken links in es/fr/zh from image
deletion resolve via post-merge translation automation.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* remove outdated images

* Update dashboard instructions for Host at toggle UI (mint #8979)

The hosting mode selector and traffic routing options were replaced with
a Host at toggle and inline base path input; routing is now inferred from
DNS. Verified against mint origin/main commit 6fb20b1789.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* 💅

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-09 18:04:01 -07:00
Ethan Palm d3d23c8d9f remove unused images 2026-07-08 12:29:06 -07:00
mintlify[bot] e142c1f28c Draft improvements from user feedback: clarify tiles examples (#6327)
* docs: use neutral placeholders in tiles component examples

* docs: mirror tiles placeholder examples in es, fr, zh

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-06-30 09:57:49 -07:00
mintlify[bot] 9510f3a70e docs: clarify Hosted MCP tab visibility (#6207)
* docs: clarify Hosted MCP tab visibility requires authentication

* update images

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-06-26 11:23:16 -07:00
Leyland Yang fcbc2d93e8 Document multi-repository deployments (#6247)
* Document multi-repository deployments

* Remove content directory step from multi-repo docs

* add UI screenshots and copy edit

* remove duplication

* vale

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-06-24 11:53:57 -07:00
Ethan Palm 0b777ec048 Editor UI updates and ask agent (#6176)
* Update index.mdx

* add images

* update tutorial

* Update git-essentials.mdx

* Update pages.mdx

* Update branching-and-publishing.mdx

* Update keyboard-shortcuts.mdx

* Update live-preview.mdx

* Create agent.mdx

* Update docs.json

* remove orphaned pages

* Update settings.mdx

* Update pages.mdx

* 💅

* update configurations
2026-06-14 14:17:56 -07:00
mintlify[bot] 198b249fef docs: document Slack notifications for workflows (#6095)
* docs: document Slack notifications and stale review reminders for workflows

* docs: translate Slack notifications section into es and fr

* add images, rewrite instructions

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-06-08 13:33:52 -07:00
Ethan Palm fbc3f9f18d Workflows updates (#6023)
* Update docs.json

* update title in link

* add link to new guide

* Update index.mdx

* first draft new guide

* Update create.mdx

* Update enable.mdx

* add reference of predefined workflows

* combine enable and manage

* update links

* Update reference.mdx

* Update create.mdx

* Update index.mdx

* Update manage.mdx

* Update use-workflows.mdx

* update images

* update workflow names

* update workflow descriptions

* clarify maintenance workflow cron vs push
2026-05-29 12:06:47 -07:00
Ethan Palm 8c8508ae86 remove flag icons (#5967) 2026-05-26 13:10:48 -07:00
skeptrune 1fedb88ca4 docs: convert search-boost page into general Search config page (#5851)
Renames optimize/search-boost.mdx to optimize/search.mdx and
restructures it so search boost is one section alongside the new
"Maximum search results" setting from mint #7771. Updates inbound
links (changelog, pages.mdx, settings-reference.mdx) to deep-link
into the boost section, adds a redirect from the old path, and
includes light/dark screenshots of the new dashboard settings page.
2026-05-18 12:00:39 -07:00
mintlify[bot] f7d8378f1e Document redirects section in editor configurations (#5705)
* Document redirects section in editor configurations

Generated-By: mintlify-agent

* 💅

* Remove translated redirect docs — handled by translation workflow

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-08 14:20:42 -07:00
Ethan Palm ec5e78af4c Editor updates (#5603)
* Update git-essentials.mdx

* Update index.mdx

* add v2 group

* recent updates

* remove v2 path

* small classic editor page

* add tutorial

* updates based on notion doc

* Create branching-and-publishing.mdx

* Update collaborate.mdx

* redirects

* update pages

* update create pages

* remove pages

* update redirects

* Update navigation.mdx

* remove redundancies

* update configurations

* 💅

* remove unused images

* update live preview

* correct image

* Add missing visual mode shortcuts and ungroup action

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-30 00:52:25 -07:00
Ethan Palm 2a1f93eedd Split workflows into structured group at /workflows/ (#5597) 2026-04-29 18:51:22 -07:00
Justin Torre 7bcd1211ad added password preview deployment docs (#5437)
* added password preview deployment docs

* Update deploy/preview-deployments.mdx

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-04-20 16:48:23 -07:00
Ethan Palm 5c73598ef3 Agent feedback (#5426)
* Update markdown-export.mdx

* add agent feedback

* update API pages

* Update analytics.openapi.json

* add note that ednpoint is always available
2026-04-17 10:06:47 -07:00
Ethan Palm baf530dedc Refresh homepage (#4656)
* them -> luma

* redo landing page

* refine

* spacing

* use images for cards

* searchbar

* searchbar

* reduce pop in

* adjust gradient

* accessibility

* gradient

* fuzz

* gradient colors

* gradient

* add icon

* frame mode

* update cards

* remove support card

* edit bottom cards

* rename image

* make search a button, add aria labels

* color contrast

* Apply suggestions from code review

Co-authored-by: dmytro <71014515+pqoqubbw@users.noreply.github.com>

* gradient on hover

* add color

* remove background image

* fix parsing error

* fix pop in

* pop in

* fix search icon

* fix link

---------

Co-authored-by: dmytro <71014515+pqoqubbw@users.noreply.github.com>
2026-04-14 18:22:50 -07:00
mintlify[bot] 2ad564729d Add Finnish (fi) to supported languages (#5171)
* Add Finnish (fi) to supported localization languages

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-04-06 14:28:26 -07:00
mintlify[bot] 33b0392e3b Add Notion MCP integration docs for the agent (#4852)
* Add Notion MCP integration page for the agent

Generated-By: mintlify-agent

* 💅

* update image

* copy edit

* fix alt text

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-25 12:44:12 -07:00
mintlify[bot] e94b00dcb8 Add Linear integration documentation (#4754)
* Add Linear integration documentation for the agent

Generated-By: mintlify-agent

* add Linear to agent index page

* update slack installation steps

* edit linear page

* Update automate-agent.mdx

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-21 10:59:11 -07:00
Ethan Palm 019d676c44 GitLab self-hosted (#4621)
* add self-hosted step

* add monorepo note

* Apply suggestion from @ethanpalm
2026-03-17 15:01:28 -07:00
Ethan Palm 806a3e7d74 add Hungarian (#4192) 2026-03-12 09:24:58 -07:00
Ethan Palm aa1728c6db Add Catalan as supported language (#4159)
* add Catalan (and alphabetize)

* add Catalan to nav page

* add Catalan to localization guide
2026-03-09 10:10:12 -07:00
Ethan Palm 716bac8bb0 Assistant improvements (#3971)
* placeholder for multimodal

* assistant improvements

* add images as context

* add multimodal

* include file info

* update dashboard URLs

* replace search suggestions image

* add file upload image
2026-03-04 10:56:08 -08:00
Ethan Palm 9fc524a891 update images (#3853) 2026-02-27 10:45:28 -08:00
Ethan Palm f1985bbae0 Updates for workflows launch (#3805)
* remove beta notice

* add plan information

* rename heading

* add use cases to intro

* add tip

* add workflows to nav

* add links to conceptual pages

* add rate limit info

* add beta info

* add dashboard option for creating a workflow
2026-02-27 08:56:13 -08:00
Ethan Palm 2391418d8a Add workflow docs (#3625)
* rename existing workflows file to use cases

* add new workflows page

* add link to agent index

* ent only for launch

* reviewer feedback

* add info on writing prompts

* add example workflows

* add more examples

* update examples frontmatter

* update changelog example

* hide page

* remove index link

* vale
2026-02-25 08:07:27 -08:00
Brandon McConnell 1cab61588a docs: add Luma theme documentation (#3749)
* docs: add Luma theme to docs

Updates various documentation sections to officially include the new Luma theme.
Adds Luma to the list of available themes and provides its description in relevant configuration and theme files.
Extends "frame" mode compatibility to include the Luma theme, reflecting its support for this layout.

* chore: losslessly compress images

used https://tinypng.com
2026-02-24 16:11:43 -08:00
Ethan Palm 4f040d5a3b Editor comments docs (#3678)
* add new pages to nav

* add comments page and images

* add suggestions page

* add PR summary info

* Vale
2026-02-24 14:23:39 -08:00
Ethan Palm 29aba2f38b Add headless guide (#3514)
* Add custom frontend use case guide

Documents the @mintlify/astro integration for building custom
documentation frontends. Covers setup from the starter repo,
how the integration works, and connecting search/assistant.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix Vale errors and broken link in custom frontend guide

Add Astro to Vale vocabulary, fix em dash spacing, and remove
broken /ai/search link.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add custom frontend link to guides index

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix Node.js version requirement to v20.17.0+

Matches the Mintlify CLI minimum requirement.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* create custom frontend guide

* Rewrite setup steps to match actual onboarding flow

* copyedit

* reviewer feedback

* add image of repo settings

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 08:10:02 -08:00
Ethan Palm 0f3871159a Editor UI changes (#3466)
* remove preview deployments

* update configuration image

* remove live preview

* update media page

* Revert "remove live preview"

This reverts commit 7f84b744b8.

* Revert "remove preview deployments"

This reverts commit da80ef4754.

* update navigation images

* Update pages.mdx

* update collaborate page with new preview UI

* update publish images

* Update index.mdx

* update live preview image
2026-02-13 16:47:49 -08:00
Brandon McConnell b5ecc979eb Update docs to include "sequoia" as a theme (#3154)
* feat: update docs to include sequoia theme

* feat: add sequoia to themes list, replace all themes thumbnails

* feat: replace all themes thumbnails in localized themes pages
2026-02-10 16:52:56 -08:00
Ethan Palm eac931190a Editor page settings (#3344)
* add image of page settings

* add light mode version of image
2026-02-09 16:44:15 -08:00
Ethan Palm 3148b9ca15 Remove all traffic option from analytics docs (#3174)
* update image

* update notes
2026-02-06 10:38:54 -08:00
Ethan Palm 0a3d2fdbbf Update GitLab setup page (#3054)
* update config image

* update webtoken image

* update procedures
2026-02-02 14:49:20 -08:00
mintlify[bot] bf46f0b40e Add AI traffic analytics documentation (#3031)
* Update optimize/analytics.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update optimize/analytics.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update optimize/analytics.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* reorganize content

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-02-02 09:39:13 -08:00
Ethan Palm 652734f393 update show help image and text (#3013) 2026-01-30 16:57:07 -08:00
Ethan Palm 3974d12fd8 remove mention of frontmatter in web editor (#2983) 2026-01-30 09:35:51 -08:00
Ethan Palm 3d79ff1d38 Assistant bot config (#2962)
* add connect apps section

* update bot pages
2026-01-28 18:19:40 -08:00
Ethan Palm 1c6fad76af Update assistant docs for new UI (#2960)
* reorder content

* move assistant insights to analytics

* create manage billing section

* update starter questions

* update search domains section

* update deflection section

* vale
2026-01-28 17:37:11 -08:00
Ethan Palm 7d545c9699 Editor updates for parity with current features (#2924)
* Add Markdown mode shortcuts to keyboard shortcuts reference

Restructure the keyboard shortcuts page to cover both Visual mode
and Markdown mode (Monaco editor). Visual mode shortcuts remain
unchanged. New Markdown mode section documents standard VS Code
shortcuts for find/replace, line manipulation, and multi-cursor
editing.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* update keyboard shortcuts

* remove out of date screenshots

* copy edit index

* add missing images

* add info to pages

* copy edit

* concision for media page

* copy edit publish

* update live preview

* update index

* add features to index

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 19:28:06 -08:00
Ethan Palm 175397dfa5 Update docs for analytics revamp (#2846)
* remove insights, set up redirects

* update feedback page

* update analytics

* add range selector image

* remove link

* vale

* clarify note

* vale
2026-01-27 11:52:09 -08:00
Ethan Palm 02b75d67bb Assistant message tiers (#2835)
* update info about tiers

* remove outdated images

* update configure info for current UI

* add message rollover info

* Apply suggestion from @mayankshouche

Co-authored-by: Mayank Shouche <43075711+mayankshouche@users.noreply.github.com>

---------

Co-authored-by: Mayank Shouche <43075711+mayankshouche@users.noreply.github.com>
2026-01-25 15:13:46 -08:00
mintlify[bot] 78a2bb1197 Pull request for mintlify/document-unused-pages-feature-2968 (#2737)
* Update editor/pages.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update editor/pages.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update editor/pages.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update editor/pages.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update editor/navigation.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update editor/navigation.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Update editor/navigation.mdx

Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* Apply suggestion from @tembo[bot]

Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>

* Apply suggestion from @tembo[bot]

Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>

* add image for existing file menu

* move content to pages

* copyedit

* fix image path

* vale

* Update editor/pages.mdx

Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>

* Update editor/navigation.mdx

Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>

* 💅

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>
2026-01-16 13:16:46 -08:00
Ethan Palm 498d6bff1c Fix support gif (#2697)
* update image

* copyedit
2026-01-14 13:55:52 -08:00