28 Commits

Author SHA1 Message Date
mintlify[bot] d920af42a2 Draft from Sep 11 (#7350)
* Updated mintlify pages

- Updated deploy/reverse-proxy.mdx

Mintlify-Source: dashboard-editor

* Updated mintlify pages

- Updated deploy/reverse-proxy.mdx

Mintlify-Source: dashboard-editor

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-11 17:58:04 -06:00
mintlify[bot] f66b301e00 fix: revert hosted docs URLs to mintlify.site domain (#7272)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-07 12:19:54 -04:00
Leyland Yang db88b6fd8c docs: replace mintlify.site with mintlifysite.com (#7226)
Claude-Session: https://claude.ai/code/session_01NrNcqnQqnVxY8H1epWe88p
2026-09-02 14:42:34 -07:00
Kaishan (Sam) Ding 4e38ae4ee9 docs: explain generated llms index routes (#7102)
* docs: explain generated llms index routes

* Apply suggestion from @ethanpalm

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

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-08-25 12:54:18 -07:00
Kaishan (Sam) Ding 04cf4b7b9d docs: document llms.txt scoped proxy routes (#7070) 2026-08-24 14:25:54 -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] 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] 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
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
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
mintlify[bot] 3ca550b188 Update from code changes: switch hosted docs domain to mintlify.site (#6296)
* docs: update hosted docs domain to mintlify.site

* docs: complete mintlify.site migration across remaining pages

Updates 45 files that PR 6282 had originally changed but were
reverted by PR 6285 and not re-addressed in this PR:

- snippets/vercel-json-generator.mdx (all 4 locales): rewrite
  destinations now use mintlify.site, consistent with deploy/vercel.mdx
- assistant/use.mdx: example deep-link URLs
- ai/skillmd.mdx: agent card subdomain reference
- guides/assistant-embed.mdx: docsURL code example
- guides/codex.mdx: MCP URL example
- deploy/authentication-setup.mdx: example Mintlify subdomain
- discovery-openapi.json: domain identifier URL descriptions (4 occurrences)
- integrations/privacy/osano.mdx: managed rule domain
- editor/branching-and-publishing.mdx: branch preview URL format
- customize/themes.mdx: theme demo site links
- guides/help-center.mdx: live example link
- zh/editor/collaborate.mdx: branch preview URL format

All changes mirrored across es, fr, and zh locales.

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-06-26 10:51:54 -07:00
Ethan Palm 2c99f3c736 Revert "Update from code changes: hosted docs domain is now mintlify.site (#6…" (#6285)
This reverts commit 553e2813ac.
2026-06-25 14:10:23 -07:00
mintlify[bot] 553e2813ac Update from code changes: hosted docs domain is now mintlify.site (#6282)
* docs: update hosted docs domain to mintlify.site

* docs: tighten zh reverse proxy intro for translation parity

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-06-25 11:58:10 -07:00
Ethan Palm 6bb14aa061 docs: replace dashboard.mintlify.com with app.mintlify.com (#5990)
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-26 15:42:09 -07:00
mintlify[bot] f14cca3b52 Standardize style and tone across docs (#5652)
* Standardize style: 'Click' to 'Select' for Mintlify UI; split long sentences

Generated-By: mintlify-agent

* Revert 'select' back to 'click' for UI interactions

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

* Fix select→click for UI elements across docs

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 15:34:08 -07:00
Ethan Palm 6beef07cd6 move note (#5720) 2026-05-08 11:49:22 -07:00
mintlify[bot] f8e015ff62 Improve SEO descriptions across 177 pages (#4993)
* Improve SEO metadata: update descriptions to 130-155 chars across 177 pages

Generated-By: mintlify-agent

* 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-03-31 16:12:58 -07:00
mintlify[bot] 2a072981b4 Document agent-skills discovery endpoint (#4793)
* Document /.well-known/agent-skills discovery endpoint

Generated-By: mintlify-agent

* Update skillmd.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-23 10:14:19 -07:00
mintlify[bot] ac3f2a356d Add llms.txt and llms-full.txt to reverse proxy routing (#4723)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-19 15:50:59 -07:00
mintlify[bot] dbdb1a298b Fix Vale style warnings across documentation (#4036)
* Fix Vale style warnings across documentation

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestions from code review

* Update guides/automate-agent.mdx

* Update integrations/analytics/adobe.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-05 10:11:54 -08:00
mintlify[bot] ba099e96f6 Clarify mintlify.dev as canonical URL for /docs deployments (#3245)
* Clarify that mintlify.dev is canonical URL for /docs deployments

* Apply suggestion from @ethanpalm

---------

Co-authored-by: Mintlify Agent <agent@mintlify.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-02-09 09:23:39 -08:00
Ethan Palm 439c95609d Add "Host at /docs" configuration for reverse proxy (#3140)
* Add "Host at /docs" configuration for reverse proxy

* Reviewer feedback

* fix vale false positives
2026-02-05 17:56:27 -08:00
Ethan Palm e819807cd8 rename "custom" to "enterprise" (#2997) 2026-01-30 10:34:54 -08:00
cdxker 0293134d0f Add skill.md and .well-known/skills/* reverse proxy configuration (#2790)
* Update deploy/reverse-proxy.mdx

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

* Update deploy/reverse-proxy.mdx

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

* Update ai/skillmd.mdx

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

* Update ai/skillmd.mdx

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

* Update deploy/reverse-proxy.mdx

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

* Update deploy/reverse-proxy.mdx

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

* Documentation edits made through Mintlify web editor

* move note

* add endline

---------

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-22 09:49:30 -08:00
Ethan Palm 4c31f3683c SEO: add keywords to pages (#1775)
* ai/ keywords

* api/ keywords

* components/ keywords

* create/ keywords

* customize/ keywords

* api-playground/ keywords

* dashboard/ keywords

* deploy/ keywords

* guides/ keywords

* insights/ keywords

* integrations/ keywords

* optimize/ keywords

* organize/ keywords

* root/ keywords

* rm temp files
2025-11-14 14:08:24 -08:00
Ethan Palm 4b68a8e5ec Update descriptions for SEO (#1767)
* add global metatags

* set "indexing": "all"

* update AI group descriptions

* api-playground descriptions

* root level page descriptions

* component descriptions

* create descriptions

* customize descriptions

* dashboard descriptions

* deploy descriptions

* guides descriptions

* insights descriptions

* api-playground

* organize descriptions

* Integrations descriptions
2025-11-13 17:14:39 -08:00
Ethan Palm 654d533b90 Task based IA (#1353)
* implement task-based IA

* rearrange pages

* tag examples

* add cookbook example

* add a components menu

* rename cookbook to guides

* fix docs.json after adding translations

* prettier docs.json

* move content to Guides

* move GEO page to guides

* draft of ai-native page

* update body with info on reading/distributing

* copy edits

* 💅

* move guides above API reference

* remove CLI sidebarTitle

* update organization

* remove tags

* remove guides icons

* Update ai-native.mdx

* Update ai-native.mdx

* copyedits

* 💅

* even number of cards

* update discovering section

* remove components tab

* remove icons

* remove icon

* add group level icons

* update Get started group

* Update organize group

* update customize group

* update create content group

* shorten URLs

* update API group

* update deploy group

* update optimize and guides groups

* set up redirects

* update links

* add pdf page

* add missing icons

* remove default expanded state

* update docs.json
2025-10-01 11:55:34 -07:00