399 Commits

Author SHA1 Message Date
mintlify[bot] 5e392dfafc Update from support feedback: advertise external MCP server (#7343)
* docs: add help center article on advertising an external MCP server

* docs: translate external MCP help center page and tighten SEO metadata

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-11 10:24:39 -07:00
mintlify[bot] 0163fb7bf8 Update from code changes: document workspace icon uploads (#7318)
* docs: add help center article on changing the workspace icon

* docs: shorten French description to meet SEO length limit

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-09 17:09:39 -07:00
Ethan Palm 6c53a28e3a Document className and Tailwind arbitrary value support (#7301)
* Document className and Tailwind arbitrary value support

All built-in components now accept a className prop (mint#10540), and
dynamic Tailwind utilities work in className on MDX components
(mint#6737). Two pages stated the opposite.

- Correct the claims that Tailwind arbitrary values are unsupported in
  customize/custom-scripts and guides/custom-layouts
- Add className and arbitrary value guidance to the Tailwind section of
  custom-scripts, including the runtime-class limitation and the Tab
  content-panel caveat
- Add a Style components section to the components overview
- Add className property rows to every component reference page that
  supports it, and note the three components that do not
- Document inline Markdown support in component title props
- Correct the callouts page, which said typed callouts accept only
  children
- Replace inline style resizing with Tailwind classes in image embeds
- Add a help center article for Tailwind classes not applying in the
  editor's live preview, and note the limitation in custom-layouts
- Point skill.md at className before custom.css
- Accept className, keyframes, and unstyled in the Vale vocabulary

Resolves DOC-316, DOC-317

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Apply batched suggestions from code review

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

* Apply batched suggestions from code review

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

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-08 16:54:20 -07:00
mintlify[bot] 13ad31c2a9 Update from code changes: document notification preferences (#7208)
* docs: document email notification preferences settings page

* docs: translate notification preferences docs into es, fr, zh

* docs: tighten es and fr notification page descriptions for SEO

* docs: add comment reaction event to notification preferences docs

* docs: remove per-category toggle claim after notifications page redesign

* move sidebar placement

* fix heading mismatch with UI

* copy edit

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-08 15:28:42 -07:00
mintlify[bot] 4e6d1412ae Update from code changes: agent IP allow list error fix (#7276)
* docs: add help center page for agent IP allow list failures

* docs: add English anchor IDs to translated headings

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-08 09:48:53 -07:00
Ethan Palm 160e74aa0f Remove stainless, fix speakeasy (#7246)
* Remove Stainless integration page and fix Speakeasy config examples

Stainless was acquired by Anthropic (announced 2026-05-18) and wound down
all hosted products, including the SDK generator: "new signups, projects,
and SDKs will not be available." The integration page documented a
hosted-platform flow (Studio -> Release tab -> Setup OpenAPI publishing)
that no new reader can complete, so it is removed and redirected to the
vendor-neutral x-codeSamples page.

Speakeasy is still operating and the integration still works, but its
docs.json examples used the pre-docs.json schema (top-level "anchors"/
"tabs" keyed on "name"/"url"). Updated to the current navigation.anchors
/ navigation.tabs shape so the snippets are copy-pasteable.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Collapse Speakeasy page into the Add SDK examples page

With Stainless removed, the Integrations > SDKs group held a single page.
Fold the Speakeasy setup steps into api-playground/adding-sdk-examples.mdx
as a "Generate examples with Speakeasy" section and drop the group.

The page now covers both routes to x-codeSamples: writing samples by hand
and pulling autogenerated ones from a Speakeasy combined spec. Old page
paths redirect to the new section anchor.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Apply batched suggestions from code review

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

* use steps

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-03 16:36:29 -07:00
mintlify[bot] 79ba9d168d docs: rename "Migrate to Mintlify" nav group to "Migration guide" (#7235)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-02 21:57:31 -07:00
mintlify[bot] c492d0780f Update from support feedback: editor branch list visibility rule (#7171)
* docs: document web editor branch list visibility rule and workarounds

* docs: add fr/es/zh translations for branch visibility updates

* docs: correct editor branch list rule and scope the URL workaround

The visibility rule as first written covered only branches pushed
directly to a Git provider. Verified against the editor branch code:
records are also soft-deleted when a pull request is merged or closed
(editorBranch.service.ts), the list defaults to PR states none/draft/open
(editorBranch.validators.ts), and cross-repository (fork) pull requests
are filtered out. Those cases match the support threads about branches
disappearing after publishing, so document them.

Also scope the URL workaround: without an editor branch record,
autocommit is skipped, the branch diff fails, and rename/delete return
404. It is a view-and-edit fallback, not an equivalent to opening a
pull request.

Drop the hand-written es/fr/zh pages and locale nav entries; those are
generated after merge.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* 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>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-31 11:08:32 -07:00
Ethan Palm 3face356bc Add bring your own model page (#7174)
* docs: document bring your own model

Add a page covering the Enterprise bring your own model (BYOK) feature:
supported providers, dashboard configuration, credit impact, and key
rotation. Cross-link it from credits, assistant configuration, the agent
overview, and the glossary.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* pare down

* 💅

* docs: clarify bring your own model is deployment-scoped

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* per deployment configs

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-28 11:08:10 -07:00
mintlify[bot] cb8af8c537 Update from code changes: document the MDX component (#7166)
* docs: document the MDX component for markdown in JSX expressions

* docs: add es/fr/zh translations for MDX component page

* Apply batched suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@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>
2026-08-28 10:15:13 -07:00
mintlify[bot] b6a700ba68 Fill gaps from assistant conversations: card icon CSS and example width (#7170)
* docs: document card icon CSS selectors and fixed example panel width

* docs: mirror card icon CSS and example width updates into es, fr, zh

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-08-28 10:08:16 -07:00
mintlify[bot] 81d71df636 Update from support feedback: renaming deployments and organizations (#7173)
* docs: add help center article on renaming deployments and organizations

* docs: apply translation heading anchors and tighten SEO descriptions

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-28 10:04:34 -07:00
mintlify[bot] f330a63890 Prune bot: merge thin/orphaned pages in deploy/ (#7141)
* refactor: merge thin and orphaned Vercel/Cloudflare deploy pages into parents

* docs: mirror deploy page merges into es/fr/zh translations and nav

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-27 08:42:50 -07:00
mintlify[bot] 8e8d75a509 Improve docs from user feedback: clarify fork support for preview API (#7078)
* docs: clarify preview API does not support fork branches

* docs: translate fork preview clarification and tighten SEO description

* 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-08-26 11:26:34 -07:00
Ethan Palm 9a4ec7b557 Editor docs overhaul (#7112)
* Fix editor docs accuracy, split media page, clear translation orphans

Accuracy fixes, each verified against mintlify/mint or mintlify/server:

- pages.mdx: "Editors and managers can restore them" -> "admins".
  "Manager" is not a Mintlify role.
- index.mdx: publishing on a feature branch does not automatically open a
  pull request; you choose commit-to-branch or PR. Contradicted the
  branching page's own table.
- branching-and-publishing.mdx: preview deployments build when you open a
  pull request, not on every branch save. Confirmed in gitlabWebhooks
  (handleMergeRequestOpenEvent) and cruxWebhooks (keyed on reviewId).
  tutorial.mdx was already correct.
- settings.mdx: rewritten against editor-settings-form.tsx. The panel has
  four sections, not "two layers", and the entire Appearance section was
  undocumented - including "Open live preview in new tab", which
  live-preview.mdx already linked readers to. Corrected three setting
  labels, noted that draft PRs default to on, added the 20,000-character
  instruction limit.
- live-preview.mdx: link now resolves to /editor/settings#appearance.

De-bloat:

- Split the media section out of pages.mdx (172 lines, 15 subtopics) into
  editor/media.mdx and added it to the nav.
- Trimmed index.mdx from 11 sidebar-duplicating cards to 4.

Translation orphans and redirects:

- Deleted 7 translated files whose English source was removed in April and
  June. The translate automation never cleaned them up, and in PR #6062 it
  wrote into es|fr|zh/editor/media.mdx 34 days after the English source was
  deleted.
- Dropped /editor/media -> /editor/pages so it stops shadowing the
  recreated page.
- Added /{es,fr,zh}/editor/publish, completing an English-only redirect.
- Added /editor/collaborate and its language variants. That page was
  deleted in June with no redirect and has been a live 404 since.

mint broken-links clean, mint a11y clean, vale 0/0/0 on changed files.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Restructure editor docs: 14 pages to 9, cut UI description

The editor section had grown to 14 pages, about 40% of which described
things a user can see on screen. The ratio was 105 field-enumeration
bullets to 42 procedural steps.

New structure, organized around what is invisible rather than what is
on screen:

  Overview      absorbs git-essentials (concepts + the Git mapping table)
  Tutorial      unchanged
  Edit content  absorbs media and navigation
  Publish       branch mechanics, conflicts, git sync, commit signing
  Review        previews, pull requests, approve and merge
  Collaborate   comments + suggestions + real-time editing
  Editor agent  trimmed
  Settings      absorbs configurations as a pointer
  Keyboard shortcuts  unchanged

Removed: git-essentials, media, navigation, live-preview, comments,
suggestions, configurations, branching-and-publishing. Added: publish,
review, collaborate.

configurations.mdx was the clearest cut. It was a 193-line field-by-field
mirror of the Site configurations panel, which is a third rendering of
information already in the docs.json schema and in organize/settings-*
(2,694 lines). It is now a short section in settings.mdx covering only
what is specific to editing configuration from the editor: real-time
sync, the SVG logo constraint, and the redirects interface.

Also cut: block actions, the minimap, code block options, right-click
menu enumerations, page settings field lists (already delegated to
/organize/pages), and most screenshots of self-evident controls.

1,320 to 848 body lines. Field-enumeration bullets 105 to 29.

English redirects added for all eight removed pages. Language variants
deliberately omitted: es/fr/zh still carry the old structure, so
redirecting those paths now would shadow pages that still exist there.
The translation automation should mirror this restructure; verify
afterward that no orphans remain.

Vale vocabulary widened rather than reworded around: autocommit(s|ed|ing)?,
autosav(e|es|ed|ing), dotfile(s)?.

mint broken-links clean, mint a11y clean, vale 0 errors on editor/.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Correct keyboard shortcuts against the editor keymap

Verified every documented shortcut against the bindings in mintlify/mint
rather than inferring them. The app-level set is exhaustive:
mod+backslash, mod+i, mod+k, mod+s, mod+shift+period, mod+z, shift+mod+d,
shift+mod+s. Visual-mode bindings come from the Tiptap extensions.

- Cmd/Ctrl+Shift+F ("Switch between Navigation and Files tree") does not
  exist. No such binding is registered anywhere in the dashboard. Replaced
  with the real binding at that spot in the UI: Cmd/Ctrl+Shift+. toggles
  "Show all files".
- Added Heading 5 and Heading 6. Heading.configure sets levels 1-6 and
  preserves the parent Mod-Alt-N shortcuts; the table stopped at 4.
- Added Cmd/Ctrl+G for accordion group, bound in Accordions.tsx.

Confirmed correct and unchanged: Cmd+K search, Cmd+I agent, Cmd+Shift+S
mode toggle, Cmd+Shift+D diff, Cmd+\ sidebar, Cmd+Shift+M comment,
Cmd+Shift+E suggesting mode, Cmd+Shift+X strikethrough, Cmd+K link,
Cmd+Enter line break, Cmd+Shift+8 unordered list, and that source mode
runs Monaco.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Document auto publish, drop the deprecated deploy branch lock

Auto publish is available to all deployments, so the settings panel shows
"Auto publish" rather than "Main branch autocommits". It is not just a
rename: when it is on, the editor hides the branch selector and the
Publish button entirely (TopBar returns null for both), so there is no
pending state and no review step. Documented that behavior in
settings.mdx and added a note at the top of publish.mdx, since that page
otherwise assumes a publish step exists.

The deployment branch lock was deprecated and removed, so it stays out of
the docs. It was already dropped from settings.mdx in the restructure.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* 💅

* copy edit index

* Fix editor docs I verified against dead code

Three claims traced to code that never mounts. Ethan confirmed the diff
shortcut does not work, which exposed the pattern.

- Removed Cmd/Ctrl+Shift+D for diff view. It is registered only at
  SubBar/index.tsx:488, inside EditorSubBar, which is exported and
  imported by nothing. There is no live diff shortcut; exitDiff exists
  only as an onClick in EditorModeContextMenu.
- Source mode runs CodeMirror, not Monaco. SourceEditor resolves through
  source-editor/index.tsx to editor-view.tsx, which imports
  @codemirror/state and @codemirror/view. Monaco is used only by
  EmbedModal. The shortcut rows themselves were correct: CodeMirror's
  defaultKeymap and searchKeymap match VS Code for toggle comment, move
  line, duplicate line, find, and add cursor above/below, all confirmed
  against @codemirror/commands.
- Rewrote the left panel section of pages.mdx. The tabs are Home and
  Publishing (EditorNavigationSidebarContents.tsx:62), not Navigation and
  Files. The Navigation/Files switcher lives in the same dead SubBar
  component. Home renders the workspace file tree including private
  pages; Publishing renders the site navigation and site settings.
  Confirmed by the e2e helper openPublishingNavigation, which queries the
  Publishing tab by role against the running app.

Also corrected in that section: the tree hides docs.json, dotfiles,
extensionless files, all-caps Markdown, and css/js/jsx/mjs/cjs/pdf unless
Show all files is on; "unlisted" was an invented term, replaced with a
link to /organize/hidden-pages; and the folder menu item is "New page",
confirmed by e2e, not "New file".

Added four source-mode bindings that are real and undocumented: Cmd+B and
Cmd+I insert Markdown markers, Cmd+Option+Shift+[ and ] fold and unfold
all.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* copy edit pages

* copy edit publish

* copy edit review

* copy edit settings

* copy edit collaborate

* Updated mintlify pages

- Updated quickstart.mdx

Mintlify-Source: dashboard-editor

* copy edit keyboard shortcuts

* Updated mintlify pages

- Updated quickstart.mdx

Mintlify-Source: dashboard-editor

* Revert "Updated mintlify pages"

This reverts commit 8d1b50cbfc.

* Updated mintlify pages

- Updated quickstart.mdx

Mintlify-Source: dashboard-editor

* fix editor edits

* Mirror the editor restructure into es, fr, and zh

Brings all three translated sites onto the same nine-page structure as
English instead of waiting for the translate automation, which has a
documented history of leaving orphans behind.

Content:
- Deleted 21 orphans: branching-and-publishing, comments, configurations,
  git-essentials, live-preview, navigation, and suggestions in each
  language. None had an English source after the restructure.
- Added publish, review, and collaborate in each language.
- Rewrote index, pages, settings, agent, and keyboard-shortcuts to match
  the current English content, including Home/Publishing tabs, CodeMirror
  source mode, Show all files, and the restored Appearance section.
- Kept the existing conventions: es uses usted, fr uses vous, keywords and
  product UI labels stay in English, and every heading is wrapped in a
  <div id="english-slug"> so cross-language anchors resolve. Verified that
  every English anchor exists in all three languages.

Navigation and redirects:
- es.json, fr.json, and zh.json now list the same nine pages as docs.json.
- Removed six locale redirects that would have shadowed the new publish
  and collaborate pages once they existed.
- Added 21 locale redirects for the removed pages and retargeted the
  destinations that pointed at them.
- Retargeted four /editor/configurations redirects that pointed at
  #site-configurations, an anchor dropped in the settings rewrite.
- Rewrote stale links in changelog, authentication-setup, concepts, and
  glossary across all three languages, since broken-links does not follow
  redirects.

English fixes needed first, all caused by the settings restructure:
- Restored ## Appearance. Two pages link to #appearance, and its four
  preferences were otherwise undocumented.
- Restored ## Create draft pull requests by default, which changelog
  links to and which defaults to on.
- Promoted Main branch autocommits from ### to ##; it was nested under PR
  instructions, and its warning named a setting no longer on the page.
- Retargeted publish.mdx from the removed #auto-publish anchor.
- Fixed a missing space in the settings page intro.

mint broken-links clean, mint a11y clean (1042 files), vale 0 errors,
all five JSON files valid.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-25 19:40:14 -07:00
mintlify[bot] 3927d41915 fix: update nav entry for renamed MDX extension page (#7109)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-25 22:15:39 +00:00
Ethan Palm 5b2a80cdc3 Mintlify MDX extension (#7108)
* docs: document the Mintlify MDX VS Code extension

Add a page for the Mintlify MDX extension (mintlify.mintlify-snippets),
which had no coverage outside a 2024 changelog entry describing its
snippets-only predecessor.

Covers autocomplete, diagnostics, hover docs, go-to-definition,
docs.json schema validation, the in-editor preview panel, surround
snippets, all four settings, and all five commands, verified against
the shipped v2.0.0 manifest and bundle.

Replace the unifiedjs.vscode-mdx recommendation in cli/install.mdx.
Our extension warns users to disable that one, so the previous
guidance routed them into a known conflict.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* docs: accept all prefetch word forms in Vale vocabulary

The vocabulary had a bare `prefetching` entry, so `prefetches` and
`prefetched` in cli/preview.mdx were flagged as misspellings. Vale
wraps entries in \b, so the bare form matches only that one variant.

Use `(?i)prefetch(es|ed|ing)?` rather than the uncased suffix pattern
used by neighboring entries. An uncased entry also generates a
case-enforcing Vale.Terms rule, which would flag a sentence-initial
"Prefetching" as an error. "prefetch" has no canonical capitalization
worth enforcing, so the non-enforcing form avoids a latent false
positive.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* rename page

* 💅

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 15:12:12 -07:00
Ethan Palm f93919ff02 Instant rollbacks (#7064)
* docs(deploy): document instant rollbacks

Add deploy/rollbacks.mdx covering how to roll back to a previous build,
how to return to the latest build, generated files that stay frozen
during a rollback, and the current limitations. Link it from the
deployments page and note the new audit log actions.

Screenshots are placeholders pending review.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* 💅

* copy edit

* typo

* better grammar

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-24 14:44:29 -07:00
mintlify[bot] 04ed35e256 Update from code changes: static export API projectId scope (#7016)
* docs: update static export API to projectId-scoped 2-step flow

* docs: language-prefix internal links and wrap translated headings

* docs: update static export example bundle URLs to mintlify-static-export-outputs-prod

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-24 10:27:57 -07:00
mintlify[bot] 68f390b5a3 Update from support feedback: private repo missing on second deployment (#7052)
* docs: add help center article for private repo missing in second deployment onboarding

* docs: translate second-deployment private repo help article and tighten English title

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-08-21 15:43:03 -07:00
mintlify[bot] c8e979f6cf Fill gaps from assistant conversations: static file 404 troubleshooting (#7051)
* docs: add help center article for static file 404 troubleshooting

* docs: translate static-file-not-served help center article to es, fr, zh

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-21 15:34:16 -07:00
Ethan Palm 3b2ab685d9 Add migration guides (#6996)
* docs: add platform migration guides

* move migrations.mdx to migrations/index.mdx

* add doc360 and fern guides

* /goal loop

* copy edit index

* copy edit doc 360

* docusaurus copy edits

* fern copy edit

* gitbook copy edit

* copy edit go-live

* resolve TODOs

* manual copy edit

* readme copy edit

* Fix GitBook terminology, Document360 export steps, and revert banner examples

- migration/gitbook.mdx: GitBook renamed spaces to sections. Their current
  docs use "section" exclusively across the Git Sync, content-structure,
  content-configuration, and reusable-content pages. Update terminology
  throughout, add a note about the older name, correct the Git Sync setup
  steps to match the real flow (Set up next to Git Sync in the section
  header, then pick a provider), and expand the direction warning with the
  version-history rollback. Add a Vale.Terms toggle so .gitbook.yaml and
  .gitbook/ paths do not trip the GitBook capitalization rule.
- migration/document360.mdx: fix "Document 360" typo and align the export
  procedure with Document360's documented dialog order, including the
  format selection, the Include media files checkbox, and downloading from
  Recent files.
- Revert components/banner.mdx and its es/fr/zh copies. The /migration link
  there is a placeholder inside an example, and translated content is
  handled by the translation pipeline.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Rename migration hub page to avoid duplicating its group name

The group is already called "Migrate to Mintlify", so the root page title
repeated it in the sidebar.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* Address migration guide nits: Fern paths, scraper page command, placeholders

- migration/fern.mdx: correct the source-content paths against Fern's
  documented project structure. Pages live in fern/docs/pages/ and assets in
  fern/docs/assets/. Add the previously missing fern/docs/snippets/,
  fern/docs/changelog/, and fern/styles.css, note that only the fern and
  changelog folder names are reserved, and map Fern snippets to Mintlify
  snippets in the component table.
- migration/index.mdx: document the scraper's page command, which was only
  documented in the deleted migration.mdx. Covered once here rather than
  repeated in each scraper-supported platform guide. Also update the GitBook
  card to say section instead of space.
- migration/readme.mdx: replace https://project.readme.io with
  https://your-project.readme.io. The former is a real login-gated project.
- migration/docusaurus.mdx: remove trailing whitespace.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* remove go live checklist

* add launch your site snippet

* update index

* 💅

* 💅

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-19 10:30:56 -07:00
mintlify[bot] 41af0c5388 Update from code changes: remove retired mint deslop command (#7005)
* docs: remove retired mint deslop CLI command

* docs: remove retired deslop API endpoint and references

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-18 09:27:39 -07:00
mintlify[bot] 07b5ff0a64 Fill gaps from assistant conversations: docs.json location + Auth0 OAuth (#6981)
* docs: clarify docs.json location and add Auth0 OAuth help center article

* docs: mirror docs.json location + Auth0 OAuth page into 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-08-14 14:37:25 -07:00
mintlify[bot] 51f9be82f8 Update from code changes: assistant link deflection and thread endpoint (#6982)
* docs: document assistant link deflection and thread transcript endpoint

* fix: correct link deflection anchor in assistant thread page

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-14 21:24:49 +00:00
mintlify[bot] f1e83ba658 Prune bot: fold what-is-mintlify and dashboard/permissions into stronger pages (#6984)
* refactor: consolidate what-is-mintlify and dashboard/permissions

* docs: wrap translated headings with English anchor slug for redirects

* Apply suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@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>
2026-08-14 14:24:26 -07:00
Ethan Palm 00445d8e71 Split analytics page into a group (#6944)
* Update redirects.json

* update links

* update nav

* create index page

* Create traffic.mdx

* Create assistant.mdx

* Create search.mdx

* Create user-engagements.mdx

* Create streaming.mdx

* Create export.mdx

* Delete analytics.mdx

* 💅
2026-08-10 16:43:32 -07:00
Ethan Palm 1c7ae48a4d Bitbucket cloud support (#6929)
* mention Bitbucket availability

* add bitbucket setup page
2026-08-10 14:48:44 -07:00
mintlify[bot] 3cb050a75a Update from code changes: document GitHub repository card (#6923)
* docs: document GitHub repository card component

* docs: translate GitHub component page and mirror nav updates

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-10 12:00:29 -07:00
mintlify[bot] 9048d8ed89 Update from support feedback: custom domain claimed by another org (#6914)
* docs: add troubleshooting for custom domain claimed by another organization

* docs: translate custom domain conflict guidance and apply style pass

* docs: move domain conflict guidance to help center

* 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-08-07 17:14:29 -07:00
mintlify[bot] f3e083cfad Update from support feedback: OpenAPI URL fetch failures during build (#6913)
* docs: add troubleshooting for OpenAPI URL fetch failures during build

* docs: translate OpenAPI fetch-failure troubleshooting to es/fr/zh

* docs: move OpenAPI fetch diagnostics to first help-center page

Split the troubleshooting accordion: the curated page keeps a complete,
compact answer, and the deep diagnostic walkthrough moves to a new
help-center page that is searchable but excluded from the sidebar.

- Add hidden + searchable "Help center" group to docs.json
- Revert es/fr/zh edits so the translation pipeline regenerates them
- Broaden the allowlist vocabulary entry to cover inflected forms

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* make help center a hidden tab

* 💅

---------

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 Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 16:05:26 -07:00
mintlify[bot] 3ee8539aaf fix: correct create/changelogs nav path in docs.json (#6903)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-07 01:20:37 +00:00
Ethan Palm a7777284dd IA refresh (#6902)
* update nav

* add concepts

* Create glossary.mdx

* add changelogs to guides

* 💅
2026-08-06 18:17:36 -07:00
Kyan Yang a698bc9897 docs: Mintlify Index (#6874) 2026-08-05 23:25:04 -07:00
mintlify[bot] 013778d27c Update from code changes: document Transcend consent integration (#6795)
* docs: document Transcend consent management integration

* docs: wrap translated headings with anchor ids and trim SEO descriptions

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-28 16:45:03 -07:00
Ethan Palm f902906027 Deprecate editor drafts (#6783)
* update nav

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

* remove drafts

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

* remove references to drafts

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

---------

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-28 13:04:11 -07:00
mintlify[bot] b0e9f88dbd docs: document dashboard session security controls (#6777)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-28 09:26:36 -07:00
Kaishan (Sam) Ding e10cfd0019 feat: assistant widget (#6754)
* feat: assistant widget

* fix

* docs: rename Assistant Widget to Mintlify Widget

* docs: shorten widget sidebar title

* add starter questions + support email

* new playground

* update

* fix

* remove bg

* remove bg

* fix

* update link

* resolve merge conflicts

* update intro, copy edit

* add prerequisites and confirmation step

* vale warning

* fix

* fix

* fkx

* fix

* fix

* live preview

* fix

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-07-27 17:37:11 -07:00
Justin Torre 5403ea14e8 Add custom developer portals doc (#6724)
* Add self-host deployment doc

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

* Add custom developer portals 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>

* Address validation style warnings in custom-portal

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>

* Apply suggestion from @ethanpalm

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-07-27 14:12:20 -07:00
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
skeptrune 6d5d62f5b3 Document SDK reference generation (typedoc, docfx, javadoc, sphinx, phpdoc) (#6717)
* Document SDK reference generation from doc-tool artifacts

* Add SDK references section to navigation reference

* Fix vale findings: active voice, accept doclet, avoid possessive
2026-07-23 17:55:52 -07:00
mintlify[bot] 60f7b3d1f3 Update from code changes: document GraphQL API reference setup (#6699)
* docs: add GraphQL API reference setup page

* docs: translate GraphQL setup page to es, fr, zh

* 💅

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-07-22 17:37:51 -07:00
Ethan Palm 0cfe37e4fd Add learn tab (#6703)
* add learn tab

* footer 💅
2026-07-22 16:31:18 -07:00
Ethan Palm 25362863b8 Decouple search and assistant endpoints (#6700)
* add search endpoint section

* fix icon label

* update index

* very clear search endpoints don't use credits
2026-07-22 15:38:06 -07:00
skeptrune 5093c9667b Add deslop endpoint to Admin API spec (#6559)
* Add deslop endpoint to Admin API spec

* Document mint deslop CLI command

* docs: add API reference page for deslop endpoint

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-17 16:26:39 -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
mintlify[bot] f4175ee8af Update from code changes: document related pages add-on (#6510)
* docs: add related pages configuration and frontmatter

* docs: translate related pages content to es, fr, zh

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestions from code review

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

* Apply suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@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>
2026-07-16 00:43:32 -07:00
Denzell 2ae9c239b0 Add editor drafts documentation (#6526)
* Add editor drafts documentation

Co-Authored-By: Denzell Ford <fdenzell@gmail.com>

* Reword drafts intro for style

Co-Authored-By: Denzell Ford <fdenzell@gmail.com>

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-07-13 15:18:35 -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 d98bd80baa add network access page 2026-07-09 13:52:53 -07:00