29 Commits

Author SHA1 Message Date
skeptrune f5eb16e900 Document seo.organization and the JSON-LD structured data graph (#6561)
* Document seo.organization and the JSON-LD structured data graph

* Fix lint warnings: spaced em dashes, node24 action versions

* Update optimize/seo.mdx

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

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-07-14 15:42:37 -07:00
mintlify[bot] e08cd283a9 Documentation quality check: fill gaps on recently updated pages (#6497)
* docs: address reader-question gaps on recently updated pages

* docs: mirror gap-filling edits 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-07-10 10:00:12 -07:00
mintlify[bot] c0cb0f4285 docs: document menu support for products in navigation (#6220)
* docs: document menu support for products in navigation

* docs: wrap new locale product menus heading in anchor div

* Updated mintlify pages

- Updated organize/navigation.mdx

Mintlify-Source: dashboard-editor

* Updated mintlify pages

- Updated organize/navigation.mdx

Mintlify-Source: dashboard-editor

* docs: note menu items accept any navigation division

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Aadit Shah <aadit2805@gmail.com>
Co-authored-by: dino475 <dean@mintlify.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-07-09 10:30:09 -07:00
Ethan Palm 2dfc941921 Custom agent instructions (#6466)
* docs: document markdown.instructions for custom agent instructions

Add a "Custom agent instructions" section to the Markdown export page
covering the markdown.instructions docs.json setting (string or array),
the rendered Agent Instructions block, and where it appears. Cross-link
it from the llms.txt structure list.

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

* 💅

* docs: add markdown block to docs.json schema reference

Document the previously-undocumented markdown config block in the
schema reference, covering markdown.schema and the new
markdown.instructions setting, in both the quick reference table and
the full property reference.

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

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-08 21:51:52 -07:00
mintlify[bot] 65e9a5bc2c docs: document zh-CN, zh-TW, and ja-JP locale codes (#6423)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-08 08:19:33 -07:00
mintlify[bot] a44502b329 docs: address recent user feedback on variables, link checker, and GitLab workflows (#6315)
* docs: clarify scope of variables, broken-links checker, and GitLab push workflows

* 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-02 13:58:50 -07:00
Ethan Palm 4cffd85891 Codex MCP guide (#6271)
* docs(DOC-389): add Codex CLI guide and MCP connection tab

Adds a guide for using OpenAI Codex CLI with Mintlify docs (AGENTS.md
config + MCP connection), adds Codex to the AI tools nav group, and
adds a Codex tab to the MCP server connection example section.

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

* docs: add Codex to AI tools list in guides index

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

* docs: update Windsurf → Devin Desktop across guides and contextual menu

windsurf.com permanently redirects to devin.ai/desktop. Updates:
- guides/windsurf.mdx: rebrand to Devin Desktop, update rules path to
  .devin/rules/, update docs links, add MCP config with correct format
- ai/contextual-menu.mdx: replace deprecated "windsurf" identifier with
  "devin-desktop" in example config, update description and keywords

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

* docs: rename guides/windsurf to guides/devin-desktop, add redirect

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

* docs: sweep remaining Windsurf → Devin Desktop references in English docs

Updates ai-native.mdx, guides/index.mdx, guides/claude-code.mdx,
organize/settings-structure.mdx, organize/settings-reference.mdx,
and cli/install.mdx. Changelogs and translation files left as-is
(changelogs are historical records; translations auto-update on merge).

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

* docs: add Codex tab to Use your MCP server section

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

* Update docs.json

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-24 21:21:03 -07:00
mintlify[bot] f31e6e40e1 docs: clarify metadata.timestamp uses git commit date (#6188)
* docs: clarify metadata.timestamp uses git commit date

* 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-16 13:26:44 -07:00
mintlify[bot] f99123ca26 docs: fix Vale warnings from PRs merged in the last week (#6081)
* docs: fix Vale warnings from PRs merged in the last week

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

* 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-04 09:48:45 -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
skeptrune ef65919462 docs: document the download-spec contextual option (#6014)
* Document download-spec contextual option

* Enable download-spec contextual option on mintlify docs site

* Explain download-spec on the OpenAPI setup page
2026-05-28 10:42:21 -07:00
Ethan Palm 925912ce5c Add Danish language (#5969)
* docs: add Danish (da) to supported language codes

* Update internationalization.mdx
2026-05-26 14:16:21 -07:00
mintlify[bot] 559b63bbc3 docs: fix Vale warnings in pages updated last week (#5883)
* docs: fix Vale warnings in pages updated last week

* docs: mirror Vale fixes into es and fr translations

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-23 03:16:25 +00:00
skeptrune 1fedb88ca4 docs: convert search-boost page into general Search config page (#5851)
Renames optimize/search-boost.mdx to optimize/search.mdx and
restructures it so search boost is one section alongside the new
"Maximum search results" setting from mint #7771. Updates inbound
links (changelog, pages.mdx, settings-reference.mdx) to deep-link
into the boost section, adds a redirect from the old path, and
includes light/dark screenshots of the new dashboard settings page.
2026-05-18 12:00:39 -07:00
skeptrune 8909948779 Document the search boost feature (#5562)
* Document the search boost feature

Add an optimize/search-boost page explaining how to bias in-product
search ranking by setting a numeric boost multiplier in page frontmatter
or on a docs.json navigation group, including inheritance rules and
de-prioritization with sub-1 values. Cross-reference from the boost
frontmatter ResponseField in organize/pages and add the new page to the
Optimize navigation group.

* Document boost in the docs.json schema reference

Add a navigation.groups[].boost subsection under navigation.groups in
the docs.json schema reference page, with a link out to the topic page.

* Apply boost: 2 to Get started and boost: 0.5 to Changelog

Bias in-product search ranking toward onboarding content and away from
the changelog. Doubles as a live test of the search boost feature.
2026-04-28 09:46:25 -07:00
mintlify[bot] 6c4c23c0b7 Document custom parameter pills via x-mint and api.params.post (#5545)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-27 15:17:51 -07:00
mintlify[bot] d4d1f8771a Document banner type and color options (#5550)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-27 15:16:01 -07:00
mintlify[bot] a963253c47 Improve directory listings documentation (#5259)
* Improve directory listings docs with better examples and clarity

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 suggestion from @ethanpalm

* Apply suggestions from code review

Co-authored-by: Brandon McConnell <brandon@dreamthinkbuild.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: Brandon McConnell <brandon@dreamthinkbuild.com>
2026-04-10 09:56:35 -07:00
mintlify[bot] ff9d66aef0 Document directory listings for navigation group root pages (#5200)
* Add documentation for directory listings on group root pages

Generated-By: mintlify-agent

* 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-04-09 15:49:59 -07:00
mintlify[bot] f7d4d6af0a Add missing properties to quick reference table and footer constraints (#5098)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-02 13:18:37 -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] 78266d9416 Remove unsupported api.spec configuration property (#4756)
* Remove undocumented api.spec configuration property

Generated-By: mintlify-agent

* fix table

* fix translated tables

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-25 17:03:33 -07:00
mintlify[bot] da6c06367c Document api.playground.credentials option (#4823)
* Document api.playground.credentials option for cross-origin requests

Generated-By: mintlify-agent

* Tighten credentials field description in playground overview

- Fix terminology inconsistency: brief description now matches the expanded
  explanation (cookies, authorization headers, TLS client certs)
- Remove editorializing ("This is useful when...") to match style of
  surrounding proxy field

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.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>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-23 17:28:05 -07:00
Kyle Finken 22510dcbfe Add composable docs json docs (#4772)
* Add composable docs json docs

title

* Update settings-reference.mdx

* Update settings.mdx

* update link

* vale

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-20 16:54:26 -07:00
mintlify[bot] 201be628b6 Remove period delimiter support from variables docs (#4761)
* Remove periods from supported variable name delimiters

Generated-By: mintlify-agent

* Update settings-reference.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-20 16:07:05 -07:00
mintlify[bot] 6b5350804d Fix Vale warnings from recent PRs (#4697)
* Fix Vale warnings from recent PRs

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* Update accept.txt

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* update vale config

---------

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-19 10:23:35 -07:00
Ethan Palm 042cb8453d Update locale codes (#4561)
* update missing locale codes

* 🇫🇷 🍁
2026-03-17 09:39:53 -07:00
mintlify[bot] 06818231f6 Add devin-mcp contextual menu option for MCP server installation (#4465)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-16 09:16:00 -07:00
Ethan Palm 9d0640aafb Improve settings page IA and readability (#4446)
* settings overview page

* update docs.json

* update links in icons snippets

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

* add schema reference

* add api settings

* add appearance settings

* add integrations settings

* add seo and search settings

* add structure

* add new contextual options

* update links

* Vale

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-13 16:17:34 -07:00