Commit Graph

52 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] 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] 1c25c440f8 docs: update sales contact email on feedback page (#5725)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-08 13:25:19 -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] 96993ddd49 docs: clarify detailed feedback only shows submissions with additional info (#5669)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-05 16:25:26 -04: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] 2016c35157 Audit and improve SEO frontmatter across docs (#5649)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-02 04:32:23 +00:00
mintlify[bot] f8fd6e6d73 Fix duplicate Tailwind class and broken frontmatter quote (#5648)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-05-02 03:10:29 +00:00
mintlify[bot] 2b1170416f Document resolution status in assistant analytics (#5569)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-28 20:46:33 -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
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
mintlify[bot] 88eb5369b1 Document robots.txt AI agent access check (#5330)
* Document robots.txt AI agent access for GEO and SEO pages

Generated-By: mintlify-agent

* 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-04-16 11:16:25 -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] ec929e19bc Document social sharing meta tag fallback behavior (#5296)
* Document fallback behavior for page-level social sharing meta tags

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-13 09:32:08 -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
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] 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] 49515b6e2e Document feedback type filtering (#4923)
* Document feedback type filtering in analytics dashboard

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-31 14:46:52 -07:00
mintlify[bot] 5a538cf416 Add OG image documentation to SEO page (#5001)
* Add dedicated OG image section to SEO docs

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-03-30 14:19:40 -07:00
Ethan Palm 089d323294 💅 (#4988) 2026-03-27 17:29:29 -07:00
mintlify[bot] 852a1ad921 Clarify how to enable email collection for feedback (#4983)
* Clarify how to enable email collection for feedback

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-27 17:20:18 -07:00
mintlify[bot] ab401f1ee9 Clarify og:image vs thumbnails.background in SEO docs (#4810)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-23 13:10:40 -07:00
mintlify[bot] 59481f87e7 Clarify that pages not in docs.json navigation are not indexed (#4437)
* Clarify that pages not in docs.json navigation are not indexed

Generated-By: mintlify-agent

* Add warning about pages not in nav being treated as hidden

Generated-By: mintlify-agent

* copyedit

---------

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 16:40:00 -07:00
mintlify[bot] 9354e31c67 Add page views metric documentation (#4261)
* Add page views metric documentation to analytics page

Generated-By: mintlify-agent

* Apply suggestion from @ethanpalm

* copyedit

---------

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 12:06:53 -07: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] 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
Ethan Palm 3dc3852b7a SEO descriptions (#4028)
* Improve SEO descriptions across 47 pages

Curated descriptions from two bot-generated PRs (#3908, #3949),
selecting the best approach for each page:
- Added missing title and description frontmatter to 10 API reference pages
- Benefit-focused descriptions for integration pages (not implementation-heavy)
- Accurate REST-aligned titles for API endpoints (Export, List, Trigger, etc.)
- Expanded short descriptions to 50–160 character range throughout

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

* copyedit

* Update custom-domain.mdx

* Fix analytics API page titles to match spec summaries

"Export" was inaccurate — spec uses "Get" for both endpoints.
Also updated descriptions to use "Retrieve" for consistency.

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

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-04 16:46:28 -08:00
mintlify[bot] 7e37ff5daf Style: convert passive voice to active voice in email collection section (#3997)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-04 14:29:08 -08:00
mintlify[bot] d45ce1e953 Add email collection documentation to feedback page (#3995)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-03-04 13:48:52 -08:00
Ethan Palm 44ebfd1ecb Auth feature availability (#3961)
* pdf exports

* sitemaps/robots.txt

* update llms.txt note

* add feature availability table

* remove parens vale rule

* vale
2026-03-03 10:39:57 -08:00
mintlify[bot] 6268d03cc2 style: convert future tense to present tense (#3717)
* style: convert future tense 'will' to present tense across docs

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 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-02-24 12:05:49 -08:00
mintlify[bot] 0dffda57f9 Fix Vale style violations (#3641)
- Changed 'file names' to 'filenames' per WordList rule
- Changed 'vs.' to 'versus' per WordList rule

Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-02-23 10:50:23 -08:00
Ethan Palm 47d3579581 Clarify hidden vs noindex relationship (#3551)
* Update optimize/seo.mdx

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

* Update organize/hidden-pages.mdx

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

* Update organize/hidden-pages.mdx

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

* copy edit

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-02-18 15:21:04 -08:00
Ethan Palm d707e65fc6 Document hidden frontmatter property (#3377)
* add note about hidden pages to SEO page

* add fronmatter props to pages.mdx

* vale

* vale

* add frontmatter option to hidden pages

* vale
2026-02-10 15:18:42 -08:00
Ethan Palm aba75bcebe Document feedback restrictions for private repos (#3191)
* Update optimize/feedback.mdx

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

* Update deploy/github.mdx

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

* Update deploy/github.mdx

* Update optimize/feedback.mdx

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-02-06 12:10:35 -08:00
Ethan Palm 3148b9ca15 Remove all traffic option from analytics docs (#3174)
* update image

* update notes
2026-02-06 10:38:54 -08:00
mintlify[bot] bf46f0b40e Add AI traffic analytics documentation (#3031)
* Update optimize/analytics.mdx

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

* Update optimize/analytics.mdx

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

* Update optimize/analytics.mdx

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

* reorganize content

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-02-02 09:39:13 -08:00
Ethan Palm e819807cd8 rename "custom" to "enterprise" (#2997) 2026-01-30 10:34:54 -08:00
Ethan Palm 25915d76ea Documentation edits made through Mintlify web editor 2026-01-28 19:09:39 -08:00
Ethan Palm 1c6fad76af Update assistant docs for new UI (#2960)
* reorder content

* move assistant insights to analytics

* create manage billing section

* update starter questions

* update search domains section

* update deflection section

* vale
2026-01-28 17:37:11 -08:00
Ethan Palm 175397dfa5 Update docs for analytics revamp (#2846)
* remove insights, set up redirects

* update feedback page

* update analytics

* add range selector image

* remove link

* vale

* clarify note

* vale
2026-01-27 11:52:09 -08:00
Ethan Palm 4ca876f1ea add automatically generated meta tags (#2025) 2025-12-03 11:05:37 -08:00
Ethan Palm d9155577de Fixes from feedback on pages (#1840)
* fix formatting

* explicitly mention what expanded: false does

* update mixpanel integratio page

* add note that integration IDs depend on provider

* add troubleshooting for preview deployments

* note page-specific metatags

* explain how MCP servers work
2025-11-21 15:38:47 -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
Mayank Shouche a0a5e93e63 fix: change indexing property to string (#1707) 2025-11-06 11:51:48 -08:00
mintlify[bot] 412b8181f0 Update SEO page link to use full URL (#1566)
* Update optimize/seo.mdx

* Update optimize/seo.mdx

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2025-10-16 11:04:44 -07:00
Ethan Palm 360346dab8 fix links (#1562) 2025-10-15 13:52:30 -07:00
mintlify[bot] 6e8b994934 Add canonical URL section to SEO documentation (#1556)
* Update optimize/seo.mdx

* Apply suggestions from code review

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2025-10-15 11:57:19 -07:00