Commit Graph

193 Commits

Author SHA1 Message Date
mintlify[bot] a6ec4be434 docs: fix Vale warnings from PRs merged in the last week (#6222)
* docs: fix Vale warnings from PRs merged in the last week

* docs: mirror Vale style fixes into es/fr/zh translations

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-06-18 10:09:09 -07:00
mintlify[bot] 99a864c4a8 docs: clarify MCP client credentials vs Mintlify API keys (#6162)
* docs: clarify MCP client credentials are distinct from Mintlify API keys

* docs: translate MCP/API key clarification note to es and fr

* 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>
2026-06-14 12:12:02 -07:00
mintlify[bot] 0d335800f3 docs: rename "Open in Windsurf" to "Open in Devin Desktop" (#6161)
* docs: rename "Open in Windsurf" to "Open in Devin Desktop" in contextual menu

* 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-12 09:12:38 -07:00
mintlify[bot] d88b484b74 docs: remove trailing periods from MCP Step titles (#6121)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-06-08 17:22:02 -07:00
Ethan Palm 7662f8fb2a Feedback resolution 2026 06 08 (#6123)
* clarify MCP returns MD

* Fix doc issues surfaced by user feedback

- Fix claude mcp add --header argument order: the flag must come after
  the positional <name> and <url> args because --header is variadic and
  otherwise consumes everything that follows it, causing the "missing
  required argument 'name'" error users reported.
- Add tip to wrap iframes in Frame component to prevent overflow (user
  suggestion on image-embeds page).
- Fix broken anchor link in quickstart CLI tab: /cli/install has no
  #clone-your-repository section; replaced with inline git clone
  instructions and a correct link to /deploy/github.

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

* Document wide-mode behavior for side panel

Wide mode hides the entire side panel (not just the TOC), including
Panel components and OpenAPI request/response examples. This was
undocumented and actively confused a user who couldn't understand why
their OpenAPI example panels disappeared on wide-mode pages.

- Fix the wide mode description in organize/pages.mdx (it previously
  said only the TOC was hidden, but ContentSideLayout.tsx returns null
  for wide/center/custom modes entirely)
- Add a Note to components/panel.mdx calling out that the side panel
  is absent on wide, center, and custom pages

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

* Resolve user feedback: clarify path formats, load timing, and analytics config

- react-components: add Constraints section (hooks pre-injected, no npm, no default exports)
- posthog: fix default host from app.posthog.com to ph.mintlify.com (confirmed via source)
- plausible: add ParamField descriptions including server field explanation
- create/text: note that internal links require root-relative paths without file extensions
- create/image-embeds: clarify image paths are root-relative, relative paths unsupported
- create/redirects: show redirects as top-level field in full docs.json example
- customize/custom-scripts: note that custom JS runs after page is interactive, applies globally

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

* 💅

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-08 17:21:31 -07:00
Ethan Palm 162c0b6ec1 clarify MCP returns MD (#6118) 2026-06-08 14:34:31 -07:00
mintlify[bot] d993e2d8c5 docs: document MCP server-card tools field and read-only annotations (#6096)
* docs: document MCP server-card tools field and read-only annotations

* docs: wrap translated server-card heading in anchor div

* 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>
2026-06-08 13:41:45 -07:00
Ethan Palm 22d210592c fix sidebarTitle 2026-06-08 10:45:48 -07:00
Ethan Palm 160dab360a fix frontmatter for Search MCP 2026-06-08 10:24:01 -07:00
mintlify[bot] 15d9eaf50c docs: document download-pdf contextual menu option (#6080)
* docs: document download-pdf contextual menu option

* Document contextual PDF download option (#6075)

* Document contextual PDF download option

* Tighten contextual PDF docs update

* Remove contextual docs formatting change

* add enterprise gate

* add link in pdf-exports page

* Update pdf-exports.mdx

---------

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

* docs: remove duplicate VS Code keyword in zh contextual menu frontmatter (#6082)

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

* docs: translate contextual PDF download updates to es and fr (#6083)

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

* docs: use sentence case for Expandable title in i18n guide (#6067)

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

* docs: tighten slack agent description length for SEO (#6078)

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

* docs: document download-pdf contextual menu option

* Update ai/contextual-menu.mdx

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Leyland Yang <yangleyland@gmail.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-06-04 09:43:19 -07:00
Leyland Yang 8b337fabd8 Document contextual PDF download option (#6075)
* Document contextual PDF download option

* Tighten contextual PDF docs update

* Remove contextual docs formatting change

* add enterprise gate

* add link in pdf-exports page

* Update pdf-exports.mdx

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-06-04 09:22:50 -07:00
mintlify[bot] af571399be docs: update A2A agent card to 0.3 schema (#6051)
* docs: update A2A agent card to 0.3 schema with supportedInterfaces

* Update ai/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-06-02 10:22:56 -07:00
mintlify[bot] 543287240c docs: improve short meta descriptions for SEO (#6044)
* docs: expand short meta descriptions on MCP and auth pages

* chore: remove stray tmp/analyze2.py

* 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-06-01 15:52:49 -07:00
mintlify[bot] 46348a7c7c docs: tighten descriptions on MCP pages for SEO (#6036)
* docs: tighten descriptions on MCP pages for SEO

* 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>
2026-05-29 15:57:11 -07:00
Ethan Palm b56d188809 Clarify MCP names (#6035)
* update admin MCP name

* update search MCP

* write gooder
2026-05-29 15:52:46 -07:00
mintlify[bot] dac7025e72 docs: add downloadApiSpec contextual menu option (#6024)
* docs: add downloadApiSpec contextual menu option

* docs: mirror downloadApiSpec option in es and fr translations

* docs: note downloadApiSpec is gated to API reference pages and auth-aware

* Apply suggestion from @ethanpalm

* 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-05-29 10:53:20 -07:00
mintlify[bot] bd073fd9c5 docs: fix Vale warnings in files changed in the last week (#6015)
* docs: fix Vale warnings in files changed in the last week

* docs: mirror Vale fixes to es and fr translations

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* 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-05-28 10:28:31 -07:00
Ethan Palm aab04325b2 a2a card and discovery endpoints (#6010) 2026-05-27 16:43:15 -07:00
Ethan Palm 47eae0cb0b Update markdown-export.mdx (#6005) 2026-05-27 11:30:31 -07:00
mintlify[bot] 07865b2d62 docs: normalize gerund headings to imperative for consistency (#6002)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-26 16:34:31 -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
Ethan Palm 15cf3ba057 llms.txt/llms-full.txt for authed vs partially authed sites (#5992)
* docs: fix llms.txt auth behavior for partially-authenticated sites

Both llms.txt and llms-full.txt are publicly accessible when a
site has any public pages, reflecting public content only.

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

* Update llmstxt.mdx

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-26 15:39:28 -07:00
mintlify[bot] 981fc11074 Fix Vale style warnings from PRs merged in the last week (#5806)
* Fix Vale style warnings from PRs merged in the last week

Generated-By: mintlify-agent

* Mirror heading slug update in translations

Generated-By: mintlify-agent

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-21 23:36:57 +00:00
mintlify[bot] 2224cca68f docs: remove undocumented MCP search parameters (#5748)
* docs: remove undocumented MCP search parameters

* docs: remove unsupported version param from MCP search parameters

* docs: restore version param and note conditional availability

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-11 13:00: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
mintlify[bot] c90f30b582 Document MCP discovery endpoint (#5715)
* Document /.well-known/mcp discovery endpoint

Generated-By: mintlify-agent

* 💅

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-05-08 11:58:22 -07:00
mintlify[bot] 89d7898cee Document expanded list_nodes filters and pagination (#5707)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-07 17:29:40 -07:00
mintlify[bot] 48944563c9 docs: clarify MCP content filtering for authenticated users (#5666)
* docs: clarify MCP content filtering for authenticated users

* 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-05-07 14:58:14 -07:00
mintlify[bot] 2731b04658 Fix style consistency issues across docs (#5694)
* Fix style consistency issues across docs

Generated-By: mintlify-agent

* 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-05-07 14:12:52 -07:00
mintlify[bot] d3a7926aeb docs: clarify client credentials MCP scope (#5675)
* docs: clarify client credentials MCP scope

* 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-05-07 10:31:57 -07:00
mintlify[bot] 693dbc361f Fix Vale style warnings from PRs merged in the last week (#5690)
* Fix Vale style warnings across docs from past week of merges

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* 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-05-07 10:28:17 -07:00
mintlify[bot] 00530a0784 docs: remove dashboard MCP link from Mintlify MCP page (#5672)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-05 11:49:29 -07:00
skeptrune 9200586a3a Boost search ranking for single-word title pages (#5670)
* docs: boost search ranking for single-word title pages

Apply `boost: 3` to English pages whose H1 / frontmatter title is a single word (e.g. "Assistant", "Quickstart", "Cards"). Short titles tend to be canonical landing pages for a topic, so users searching the exact term should land on them first.

* docs: drop boost on websocket-playground stub to keep canonical Playground ranking

`api-playground/websocket-playground.mdx` is an auto-generated AsyncAPI stub with no body content but shares the title "Playground" with `api-playground/overview.mdx`. Boosting both equally diluted the canonical overview page in search for the query "playground". Drop the boost on the stub.
2026-05-05 10:30:58 -07:00
mintlify[bot] 5703f2321e docs: update Model Context Protocol page title to include MCP acronym (#5667)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-04 23:19:32 -07:00
mintlify[bot] cbc5fb070b Fix style consistency issues across docs (#5641)
* Fix style consistency issues across docs

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-05-01 16:26:44 -07:00
Ethan Palm f3cc9308e0 fix: add -L flag to curl example in markdown-export (#5629)
The URL redirects, so without -L the command silently fails.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-01 11:32:35 -07:00
Ethan Palm 08e2664110 add links to Mintlify MCP (#5626) 2026-05-01 11:09:41 -07:00
mintlify[bot] a33f596c4f docs: remove Discord bot pages (#5619)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-30 16:00:06 -07:00
mintlify[bot] c33a91e87f Update quickstart and AI docs (#5614)
Mintlify-Source: dashboard-editor

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-30 14:47:01 -07:00
mintlify[bot] 9a85685fc1 Update Mintlify MCP URL in config example (#5611)
Mintlify-Source: dashboard-editor

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-30 10:34:17 -07:00
mintlify[bot] 52353cdb4d Document list_branches tool in Mintlify MCP (#5605)
* Document list_branches tool in Mintlify MCP

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-30 10:25:17 -07:00
mintlify[bot] ef4515692b docs: add admin MCP page (#5587)
* Add Admin MCP documentation and navigation link

Mintlify-Source: dashboard-editor

* refactor: rename Admin MCP to Mintlify MCP and move under Guides › AI

* refactor: move Mintlify MCP to Documentation › Create content and address review

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-29 11:00:52 -07:00
mintlify[bot] b9cfd7824b Add AI tool tips to key docs pages (#5582)
* Add AI tool tips and skill.md install prompts to key pages

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-28 17:10:34 -07:00
mintlify[bot] 9124dad734 Document ai.markdown.apiSpec configuration (#5572)
* Document ai.markdown.apiSpec configuration option

Generated-By: mintlify-agent

* Update config key to markdown.openapi

Generated-By: mintlify-agent

* Update config key to markdown.schema

Generated-By: mintlify-agent

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-28 15:02:43 -07:00
mintlify[bot] 7f9a1c5230 Update client credentials token response to include refresh_token (#5466)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-24 10:56:13 -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 6187247856 Create assistant group (#5411)
* add redirect

* update links

* remove old page

* create index page

* Create configure.mdx

* Create customize.mdx

* Create use.mdx

* Update docs.json
2026-04-16 11:09:02 -07:00
mintlify[bot] d815043baf Add Visibility section to markdown export page (#5362)
* docs: add Visibility cross-reference to markdown export page

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-14 14:11:22 -07:00
Ethan Palm 35d6fe0252 MCP tools: query docs filesystem and skills (#5333)
* add info on skills as MCP resources

* update MCP resources/tools

* remove get_page
2026-04-13 15:26:47 -07:00
mintlify[bot] f152fc42e7 Add bot protection docs for assistant (#5264)
* Add bot protection section to assistant docs

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-10 13:52:54 -07:00