Commit Graph

187 Commits

Author SHA1 Message Date
mintlify-development[bot] 238867bd72 docs: apply brand tone and writing style fixes (#7084)
Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
2026-08-25 10:16:37 -07:00
mintlify[bot] 11bb57f9b4 Documentation quality check: document deployment history (#7077)
* docs: add deployment history section to deployments page

* docs: translate deployment history section into es, fr, zh

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-25 09:19:17 -07:00
mintlify[bot] 4719ed7ae4 Apply brand tone and writing style fixes (#7072)
* docs: fix GitHub App casing and passive voice in deployments page

* 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-24 14:59:02 -07:00
mintlify[bot] 8024e05a3c docs: note https and public-address requirement for self-hosted GitLab host URL (#7065)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-24 14:45:30 -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
Kaishan (Sam) Ding 04cf4b7b9d docs: document llms.txt scoped proxy routes (#7070) 2026-08-24 14:25:54 -07:00
mintlify[bot] 8222d59e2c docs: split long sentences in multi-repo deployments page (#6997)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-17 11:30:03 -07:00
Leyland Yang 39d1a868bc Document variable merging in multi-repository deployments (#6994)
* Document variable merging in multi-repository deployments

* Apply suggestions from code review

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

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-08-17 11:24:38 -07:00
mintlify[bot] 77b4022eef docs: apply brand tone and writing style fixes (#6983)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-14 11:18:01 -07:00
Marco Dewey 5fa5efc31e Document personalization and JWT login options (#6959)
* Document personalization and JWT login options

* update expiresAt value, clarify auth vs. personalization

* Update custom-scripts.mdx

* copy edit

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-08-14 10:59:59 -07:00
mintlify[bot] ca26814ba0 Update from code changes: note Pro+ plan for self-hosted GitLab OAuth (#6972)
* docs: note Pro+ plan requirement for self-hosted GitLab OAuth

* Apply suggestion from @ethanpalm

* Update es/deploy/gitlab-self-hosted.mdx

* Update fr/deploy/gitlab-self-hosted.mdx

* Update zh/deploy/gitlab-self-hosted.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-08-14 10:59:27 -07:00
mintlify[bot] f3b088b1d6 docs: apply brand tone and writing style fixes to Bitbucket page (#6931)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-10 14:56:02 -07:00
mintlify[bot] 94aae43575 docs: fix grammar in Bitbucket Cloud additions (#6930)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-10 21:51:10 +00: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] 4df6199783 docs: document sourceRef support inside tab menu arrays (#6901)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-10 14:40:07 -07:00
mintlify[bot] 47f912262e docs: apply SEO and metadata best practices (#6928)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-10 11:43:36 -07:00
mintlify[bot] 3b78dd9d26 Update & deprecate from code: document analytics updates (#6856)
* docs: document analytics and authenticated previews

* docs: polish translated analytics updates

* remove duplicative content

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* 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-10 11:03:28 -07:00
mintlify[bot] e3d9a5ade2 Documentation quality check: address reader-question gaps (#6922)
* docs: address reader-question gaps flagged by quality check

* docs: mirror English gap fixes to es, fr, zh translations

* 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-10 09:51:50 -07:00
mintlify[bot] e2787cfd93 Apply brand tone and writing style fixes (#6893)
* docs: standardize documentation writing style

* docs: apply brand tone and style fixes

* docs: refine brand tone and writing style

* Revert changelog.mdx changes

The changelog is generated content and shouldn't be rewritten by the
brand tone and writing style pass.

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

* Update ai/model-context-protocol.mdx

* Update ai/model-context-protocol.mdx

---------

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:56:42 -07:00
mintlify[bot] df4c082fc2 Update from code changes: document OAuth group claims (#6887)
* docs: document OAuth group claim delimiters

* docs: refine localized authentication pages

* 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-06 09:48:39 -07:00
mintlify[bot] 6c90338de2 Vale style audit: fix warnings from PRs merged in the last week (#6817)
* docs: fix Vale warnings in widget browser API table and Cloudflare troubleshooting

* docs: mirror widget Browser API table fix into es, fr, zh translations

* Apply suggestion from @ethanpalm

* 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-07-30 10:35:37 -07:00
Ethan Palm 0e57fcbfd9 Revert OAuth token claims documentation (#6684, #6690) (#6811)
The token claims feature (deriving OAuth groups from JWT claims) isn't
shipped yet, so its docs shouldn't have merged. This reverts both the
original PR and its follow-up precedence clarification.

This reverts commit e3257c2d8b.
This reverts commit d2378037d9.
2026-07-29 15:00:00 -07:00
mintlify[bot] e442b85b5e Apply brand tone and writing style fixes (#6757)
* docs: apply brand tone and writing style fixes to subpath proxy pages

* docs: fix duplicated word and double space in custom portal doc

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-27 15:35:45 -07:00
mintlify[bot] 131cfda71c Apply SEO and metadata best practices (#6755)
* docs: clarify Route 53 and CloudFront page title for SEO

* docs: clarify Route 53 and CloudFront titles in es/fr/zh translations

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-27 15:34:26 -07:00
mintlify[bot] 9e37a3b6a5 docs: fix duplicate word and double space in custom-portal (#6761)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-27 21:14:06 +00: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
mintlify[bot] 41d5ab8737 docs: fix typo and double space in Cloudflare subpath docs (#6756)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-27 20:32:19 +00:00
Alejandro Cortez 78dd891fa5 Document /mintlify-assets and /_mintlify routing for subpath proxies (#6687)
* Document /mintlify-assets and /_mintlify routing for subpath proxies

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

* Update deploy/cloudflare.mdx

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-07-27 16:29:00 -04:00
mintlify[bot] 629f648c57 Apply brand tone and writing style fixes (#6720)
* docs: apply brand tone and writing style fixes

* docs: split long sentences in self-host page

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-24 11:35:09 -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
mintlify[bot] 947f25eef7 docs: require installation owner for GHES setup (#6695)
* docs: require installation owner for GHES setup

* docs: use active voice for installation owner description

* docs: scope GHES installation owner to organizations

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-22 13:19:39 -07:00
mintlify[bot] d2378037d9 Documentation quality check: clarify OAuth token claims precedence (#6690)
* docs: clarify token claims precedence over info API URL

* docs: mirror token claims precedence note to 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-07-22 11:07:09 -07:00
mintlify[bot] e3257c2d8b Update from code changes: document OAuth token claims for groups (#6684)
* docs: document OAuth token claims for group derivation

* docs: translate OAuth token claims section (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-07-21 10:30:07 -07:00
mintlify[bot] ade1fbbd39 Documentation quality check: fill gaps in recently updated pages (#6633)
* docs: address reader-question gaps in recently updated pages

* docs: shorten analytics description, split long sentence, mirror translations

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-17 15:06:01 +00:00
mintlify[bot] 5bf909de05 Draft improvements from user feedback: clarify ignore/sourceRef/monorepo/domain (#6408)
* docs: clarify mintignore, sourceRef, monorepo toggle, static export domain

* docs: mirror translations for mintignore/multi-repo/monorepo/static-export updates

* 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 17:13:01 -07:00
mintlify[bot] 45d85bb3f8 Update from code changes: document root URL path for multi-repo (#6379)
* docs: document root URL path for multi-repo deployments

* docs: wrap translated section headings in div anchors

* 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-07-16 17:07:00 -07:00
mintlify[bot] 7805ae6dcc docs: add missing period in route53 cloudfront note (#6615)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-16 18:50:52 +00:00
mintlify[bot] f8c37ea546 Apply brand tone and writing style fixes (#6552)
* docs: apply brand tone and writing style fixes to ci.mdx

* Update deploy/ci.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-07-14 10:06:27 -07:00
Ethan Palm b65008e724 Update ci.mdx (#6551) 2026-07-14 10:03:14 -07:00
mintlify[bot] 54f9721835 Apply brand tone and writing style fixes (#6532)
* docs: apply brand tone and writing style fixes

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* 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-07-13 16:31:33 -07:00
Ethan Palm 0922398042 fix link to git settings 2026-07-13 16:08:00 -07:00
mintlify[bot] 31ea2c2af6 docs: remove Feedback add-ons unavailable troubleshooting section (#6515)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-12 16:33:59 -07:00
mintlify[bot] 2214a338a3 Update from support feedback: fork PR preview limitation (#6443)
* docs: document fork PR preview limitation and workaround

* docs: translate fork PR preview limitation to es, fr, zh

* 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-10 15:01:53 -07:00
mintlify[bot] 585414fc09 docs: tighten wording in AWS subpath guide (#6506)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-10 14:40:03 -07:00
mintlify[bot] 0b6eed1534 fix: correct singular/plural agreement in AWS subpath cache policy list (#6505)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-10 17:22:02 +00:00
Alejandro Cortez 0b9226357b Document required HTTP methods for subpath proxies (#6502)
CloudFront behaviors default to allowing only GET and HEAD, which
silently blocks the POST requests used for Mintlify analytics. Add
allowed-methods guidance to the AWS guide and the generic reverse
proxy page, and resolve the CachingOptimized/CachingDisabled
contradiction in the AWS guide.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 13:20:27 -04:00
mintlify[bot] aeee4d4eb1 Apply SEO and metadata best practices (#6489)
* docs: improve SEO title and descriptions for custom domain and Vercel pages

* Apply suggestion from @ethanpalm

* 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-07-10 09:15:57 -07:00
mintlify[bot] 7685f77eea Apply brand tone and writing style fixes (#6487)
* docs: apply brand tone and writing style fixes to custom domain pages

* docs: capitalize Worker in Cloudflare test heading for consistency

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-10 09:14:24 -07:00
mintlify[bot] 9540ae22d9 docs: fix grammar and formatting in custom domain guides (#6488)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-10 01:07:39 +00: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