skills/mintlify__docs
1
0
Fork 0
mirror of https://github.com/mintlify/docs.git synced 2026-09-14 13:35:46 +08:00
Code Issues Packages Projects Releases Wiki Activity
3,151 Commits 1,654 Branches 0 Tags
api-overhaul
Commit Graph

132 Commits

Author SHA1 Message Date
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
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] 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
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
Han Wang f8b7762bee Update 2026-05-01 21:21:20 -07:00
Han Wang 31bb7244a4 Add heights 2026-05-01 20:10:21 -07:00
Han Wang 32525d1906 Update icons 2026-05-01 20:05:14 -07:00
Han Wang 90930744d6 Fix SVGs 2026-05-01 20:01:18 -07:00
Han Wang 2feedc303f Add heights 2026-05-01 19:39:19 -07:00
Han Wang d325a3bb3a Update clearbit 2026-05-01 19:38:39 -07:00
Han Wang c931048770 remove /docs in clarity 2026-05-01 19:30:50 -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] 844e0f0c14 Document Heap analytics event tracking (#4816) 
* Document Heap analytics event tracking support

Generated-By: mintlify-agent

* alphabetize cards

* concision

---------

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 17:11:22 -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
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] 459e22fd13 Fix passive voice in Speakeasy integration docs (#3847) 
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-02-27 11:14:28 -08:00
mintlify-development[bot] f91dfb8ab5 style: fix passive voice in analytics overview (#3841) 
Rewording to use active voice per Vale style guide
Generated-By: mintlify-agent

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
 2026-02-27 11:13:46 -08:00
mintlify-development[bot] 00984f6d77 Replace 'whitelist' with inclusive 'allowlist' terminology (#3737) 
Generated-By: mintlify-agent

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
 2026-02-27 11:03:09 -08:00
mintlify[bot] fc8939756b Fix trailing whitespace in Speakeasy docs heading (#3832) 
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-02-26 17:09:01 -08:00
mintlify-development[bot] 08061629f2 Fix typo: 'analytic' to 'analytics' in heading (#3836) 
Generated-By: mintlify-agent

Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
 2026-02-26 17:08:24 -08:00
Leyland Yang 2f66d0ba99 adobe analytics page (#3829) 
* adobe analytics page

* update logo SVG

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
 2026-02-26 17:04:08 -08:00
mintlify[bot] e9da369dff Fix Vale style warnings: future tense to present tense (#3823) 
* Fix Vale style warnings: replace future tense with present tense

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-02-26 16:39:36 -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] 4e69772d60 Fix Vale style violations: sentence case headings and AM/PM format (#3614) 
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-02-20 17:17:22 -08:00
mintlify[bot] 80e1e20c07 Fix Vale style violations (#3573) 
- Remove exclamation point in hidden-page-example.mdx
- Replace 'click on' with 'click' in google-analytics.mdx
- Replace 'open-source' with 'open source' in maintenance.mdx

Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-02-20 09:14:12 -08:00
Ethan Palm ab04a0c437 fix anchor links (#3516) 2026-02-17 16:06:55 -08:00
mintlify[bot] a7025a0d27 Enable add-mcp in contextual menu (#3366) 
* Add add-mcp contextual menu option to documentation

* Add add-mcp to contextual menu options

* Apply suggestion from @ethanpalm

* Apply suggestion from @ethanpalm

* 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-10 11:33:00 -08:00
mintlify[bot] 2afbab0d46 Add add-mcp contextual menu option (#3365) 
* Add add-mcp contextual menu option to documentation

* Enable add-mcp in contextual menu config

---------

Co-authored-by: Mintlify Agent <agent@mintlify.com>
 2026-02-10 11:27:48 -08:00
Ethan Palm 5b18420c52 Update Osano integration (#3186) 
* remove Osano from settings

* remove docs.json setup from prviacy/overview

* fix Osano card

* update Osano page with JS method

* vale
 2026-02-06 12:15:51 -08:00
mintlify[bot] e83ce16353 Clarify analytics API key security (#3130) 
* Clarify that analytics integrations use public API keys

* Update integrations/analytics/overview.mdx

---------

Co-authored-by: Mintlify Agent <agent@mintlify.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
 2026-02-05 17:59:49 -08:00
Ethan Palm 70a57f5766 Add docs.content.md.view analytics event (#3048) 
* Update integrations/analytics/overview.mdx

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

* Apply suggestion from @ethanpalm

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-02-02 13:45:31 -08:00
mintlify[bot] 3db3e10f05 Update integrations/analytics/overview.mdx (#2762) 
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-01-21 17:54:44 -08:00
Ethan Palm 428d38fb9e Feedback fixes (#2603) 
* add explanation of plausible server

* add info on aligning table columns

* clarify API keys

* add example API use cases

* update link to API auth

* remove passive voice
 2026-01-08 10:12:33 -08:00
Ethan Palm e1ad682118 Update integrations/analytics/overview.mdx (#2463) 
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2025-12-19 11:23:44 -08:00
cdxker 65ef91ccc8 Update analytics event names for assistant feedback and add new autopilot events (#2434) 
* Update integrations/analytics/overview.mdx

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

* Update integrations/analytics/overview.mdx

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

* Apply suggestions from code review

* update headers

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
 2025-12-19 10:15:59 -08:00
mintlify[bot] 2b9ec579d8 Improve analytics overview page clarity (#2421) 
* Update integrations/analytics/overview.mdx

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

* Update integrations/analytics/overview.mdx

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

* Update integrations/analytics/overview.mdx

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

* Update integrations/analytics/overview.mdx

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

* Update integrations/analytics/overview.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>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
 2025-12-19 10:01:27 -08:00
mintlify[bot] c7a95eb4a6 Update integrations/analytics/posthog.mdx (#2447) 
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2025-12-18 16:11:46 -08:00
Leyland Yang 2d2ea0da04 Remove deprecated assistant feedback analytics events (#2202) 
* Update ai/assistant.mdx

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

* Update integrations/analytics/overview.mdx

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

* Apply suggestions from code review

* 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>
 2025-12-12 17:45:17 -08:00
mintlify[bot] a878f8319e Update integrations/analytics/overview.mdx (#1927) 
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2025-12-01 09:18:57 -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 6677525efa Fixes from code block feedback (#1837) 
* add intercom placeholder value

* fix Osano code block

* remove deprecated attribute
 2025-11-21 15:04:57 -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
dmytro efb9e3b44a Fix clarity icon (#1764) 
* remove svg tags

* wip

* fix icon

* wip

---------

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
 2025-11-13 22:48:55 +01:00
Ethan Palm 34bcd871b9 Fix Clarity icon (#1758) 
* remove svg tags

* wip

---------

Co-authored-by: pqoqubbw <pqoqubbw@gmail.com>
 2025-11-13 13:34:52 -08:00
mintlify[bot] 75e1a4fbb0 Add Microsoft Clarity analytics integration documentation (#1740) 
* Update integrations/analytics/clarity.mdx

* Update integrations/analytics/overview.mdx

* Update integrations/analytics/overview.mdx

* Update docs.json

* Update docs.json

* Update docs.json

* Update docs.json

* Update docs.json

* Update docs.json

* Update docs.json

* Update docs.json

* Update docs.json

* Update docs.json

* fix docs.json

* update icon

* Update integrations/analytics/clarity.mdx

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: pqoqubbw <pqoqubbw@gmail.com>
Co-authored-by: dmytro <71014515+pqoqubbw@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
 2025-11-12 21:59:03 +01:00
mintlify[bot] 99eafac319 Clarify telemetry disabling affects feedback feature (#1682) 
* Update organize/settings.mdx

* Update insights/feedback.mdx

* Update integrations/privacy/overview.mdx

* Update organize/settings.mdx

* Update insights/feedback.mdx

* Update integrations/privacy/overview.mdx

* move note in Feedback

* update notes

---------

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-31 10:47:44 -07:00
mintlify[bot] 3fd7767f4b Add PostHog sessionRecording configuration documentation (#1628) 
* Update integrations/analytics/posthog.mdx

* Update integrations/analytics/posthog.mdx

* Update integrations/analytics/posthog.mdx

---------

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-27 18:47:24 -07:00
Ethan Palm c5bd07bff1 Deprecate koala (#1496) 
* remove Koala page

* remove Koala from analytics overview

* remove Koala CSP configurations

* remove Koala from settings reference
 2025-10-08 11:09:16 -07:00
Ethan Palm befa80e35d add alt text (#1445) 2025-10-03 14:09:31 -07:00