140 Commits

Author SHA1 Message Date
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 bea304041c docs: document searchable for hidden tabs and groups (#5837)
Adds the `searchable: true` option to the Hidden pages guide as the
second way to expose hidden content to search, sitemap, AI context,
and search engines. Cross-references it from the SEO sitemap section.

Use `seo.indexing: "all"` for site-wide opt-in, or `searchable: true`
on a specific hidden tab or group when only that subtree should be
discoverable.
2026-05-16 15:58:11 -04:00
mintlify[bot] 76726a20ee docs: remove country flags from supported languages list (#5830)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-15 16:48:51 -07:00
mintlify[bot] 83fd1b5b7f docs: replace contact sales link with workflows for automated translations (#5681)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-06 11:06:09 -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
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] 355de73f7b Clarify seo.indexing override in hidden pages callout (#5507)
* Clarify seo.indexing override in hidden pages callout

Generated-By: mintlify-agent

* Clarify hidden page indexing behavior

Mintlify-Source: dashboard-editor

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Dean from Mintlify <dean@mintlify.com>
2026-04-23 14:57:10 -07:00
Ethan Palm 5099a23fb8 User feedback 4-10-2026 (#5295)
* fix JSON

* note about local builds

* broken links clarification
2026-04-10 14:59:16 -07:00
mintlify[bot] 0b0c8af624 Fix Vale style warnings from recent merged PRs (#5247)
* Fix Vale style warnings across 11 documentation files

Convert passive voice to active voice, fix sentence-style capitalization,
and update word choice per Vale linter suggestions.

Generated-By: mintlify-agent

* Apply suggestions from code review

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

* 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-04-10 14:00:16 -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] 2ad564729d Add Finnish (fi) to supported languages (#5171)
* Add Finnish (fi) to supported localization languages

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-06 14:28:26 -07:00
Ethan Palm db3ca0500d CLI updates (#5150)
* update skills

* update migration guide

* update API migration guide

* update assistant page

* update analytics page

* update CLI commands

* deprecate openapi-check

* add coming soon

* update docs.json

* add index page

* add install page

* add preview page

* add analytics

* add commands reference

* update links

* delete installation.mdx

* add optional prereq steps

* Add telemetry section to commands reference

Incorporates telemetry content from #5039 which was merged to main after
this branch was created. Documents opt-out flags, env variables, and
config persistence.

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

* move global flags to top

* vale

* remove `mint upgrade`

* remove unnecessary prereq

* restructure analytics commands

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-06 10:40:51 -07:00
mintlify[bot] 63f716768d Improve SEO descriptions on 19 pages (#5152)
* Improve SEO descriptions on 19 pages with short metadata

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-04-06 10:26:12 -07:00
Ethan Palm ac8fbd6b55 Address feedback 2026-04-03 (#5144)
* Fix invalid navigation $ref example in settings docs

The config/navigation.json example showed a bare array, but navigation
is an object with a groups key. Updated the example to match the actual
schema so users copying it get working configuration.

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

* Move CLI installation page to Get started nav group

Searches for "cli" had 22 hits with 0% CTR. The installation page was
buried in Create content between web editor docs and text formatting.
Moving it to Get started makes it findable alongside quickstart.

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-03 17:00:11 -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] 6725a71aaf Document hideFooterPagination and hideApiMarker frontmatter options (#4942)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-26 18:11:10 -07:00
mintlify[bot] a0ee4ef597 Fix Vale style warnings from recent PRs (#4900)
* Fix Vale style warnings from recent PRs

Generated-By: mintlify-agent

* alphabetize accept list

* remove unnecessary terms

* combine lists

* alphabetize

* add (?i)

* update wordlist

* remove default vocab

* Apply suggestions from code review

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

* Update accept.txt

---------

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-26 10:18:53 -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] 69754806f3 Document build/ as reserved directory name (#4853)
* Document build/ as reserved directory for static files

Generated-By: mintlify-agent

* update default ignored patterns

---------

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-24 14:57:01 -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
mintlify[bot] c2dfcce65b Add guide on custom page layouts (#4787)
* Add guide on custom page layouts and landing pages

Generated-By: mintlify-agent

* add theme support to table

* more precise CSS language

* use Lucide icon name

* copy edit

* accuracy

* 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-03-21 11:33:28 -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
mintlify[bot] b1c23ca8b4 Add warning about hidden: false undefined behavior (#4694)
* Add warning about hidden: false undefined behavior

Generated-By: mintlify-agent

* remove zh/ translation

* update param in pages.mdx

* move info

---------

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 09:12:25 -07:00
mintlify[bot] ac0cd6ffa3 Add groups frontmatter field to page metadata reference (#4544)
* Add groups frontmatter field to page metadata reference

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-03-17 11:33:28 -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
mintlify[bot] 4e05bf2346 Add Google AI Studio to contextual menu options (#4427)
* Add Google AI Studio to contextual menu options

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-03-13 12:18:51 -07:00
mintlify[bot] c5e9e5ced5 Add tabler to icons.library documentation (#4398)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-12 17:20:54 -07:00
Ethan Palm 806a3e7d74 add Hungarian (#4192) 2026-03-12 09:24:58 -07:00
mintlify-development[bot] 1941f2cf7b Fix Vale style warnings from CI checks (#4348)
* Fix Vale style warnings from recent PRs

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-11 17:10:05 -07:00
mintlify[bot] b591e74398 Clarify that footer is hidden on custom mode pages (#4347)
* docs: clarify that footer is hidden on custom mode 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-03-11 17:07:15 -07:00
mintlify[bot] e99bed57f4 Add missing 'assistant' option to contextual menu documentation (#4343)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-11 12:07:13 -07:00
mintlify-development[bot] c93df3f3f8 Document auto-generated page title fallback (#4331)
* docs: document auto-generated title fallback for .md files

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-11 11:31:44 -07:00
mintlify[bot] 682fe3e2cc Document default property for version navigation (#4311)
* Document default property for version navigation

Generated-By: mintlify-agent

* 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-03-11 11:29:06 -07:00
mintlify[bot] 90bf77d3ca Document localized footer and navbar for multi-language sites (#4209)
* Document localized footer and navbar for multi-language sites

Generated-By: mintlify-agent

* Improve i18n guide prose for localized footer/navbar section

- Replace passive intro with action-oriented opening
- Add explicit instruction to add footer/navbar to language config
- Tighten closing sentence on inheritance behavior
- Add banner mention for parity

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

* fix JSON example and language code

* fix links

---------

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-10 15:19:10 -07:00
mintlify[bot] 1972dd9eca Document deprecated frontmatter field for pages (#4239)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-10 09:32:10 -07:00
Ethan Palm 0746a9082e Redirect status codes (#4228)
* update settings

* update redirects
2026-03-09 16:53:45 -07:00
mintlify-development[bot] 6b6aec077e docs: clarify logo href behavior for internationalized docs (#4177)
Generated-By: mintlify-agent

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
2026-03-09 13:29:00 -07:00
Ethan Palm aa1728c6db Add Catalan as supported language (#4159)
* add Catalan (and alphabetize)

* add Catalan to nav page

* add Catalan to localization guide
2026-03-09 10:10:12 -07:00
mintlify[bot] 7aaff16117 Link to full API languages list from settings reference (#4112)
* Link to full API languages list from settings reference

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-03-06 15:20:31 -08:00
mintlify-development[bot] ad11bc265d Fix Vale style warnings: passive voice and punctuation (#4057)
* Fix Vale style warnings: passive voice and punctuation

- Convert passive voice to active voice in multiple component docs
- Fix quotation mark punctuation in navigation.mdx
- Update heading text to use correct casing
Style-only changes that don't affect content meaning.
Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-03-06 09:11:24 -08:00
mintlify[bot] 1ff58f58c3 Add Adobe, Koala, and PostHog sessionRecording integration docs (#4061)
* Add Adobe, Koala, and PostHog sessionRecording 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-03-06 08:56:54 -08:00
mintlify-development[bot] bcdd88c3c5 Document api.url config for full base URL display (#4041)
Generated-By: mintlify-agent

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
2026-03-05 17:58:55 -08:00