15 Commits

Author SHA1 Message Date
Ethan Palm 5b2a80cdc3 Mintlify MDX extension (#7108)
* docs: document the Mintlify MDX VS Code extension

Add a page for the Mintlify MDX extension (mintlify.mintlify-snippets),
which had no coverage outside a 2024 changelog entry describing its
snippets-only predecessor.

Covers autocomplete, diagnostics, hover docs, go-to-definition,
docs.json schema validation, the in-editor preview panel, surround
snippets, all four settings, and all five commands, verified against
the shipped v2.0.0 manifest and bundle.

Replace the unifiedjs.vscode-mdx recommendation in cli/install.mdx.
Our extension warns users to disable that one, so the previous
guidance routed them into a known conflict.

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

* docs: accept all prefetch word forms in Vale vocabulary

The vocabulary had a bare `prefetching` entry, so `prefetches` and
`prefetched` in cli/preview.mdx were flagged as misspellings. Vale
wraps entries in \b, so the bare form matches only that one variant.

Use `(?i)prefetch(es|ed|ing)?` rather than the uncased suffix pattern
used by neighboring entries. An uncased entry also generates a
case-enforcing Vale.Terms rule, which would flag a sentence-initial
"Prefetching" as an error. "prefetch" has no canonical capitalization
worth enforcing, so the non-enforcing form avoids a latent false
positive.

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

* rename page

* 💅

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-25 15:12:12 -07:00
mintlify-development[bot] 9eacdd67e0 docs: note plan requirement and add mint analytics to CLI overview (#7094)
Co-authored-by: mintlify-development[bot] <109878554+mintlify-development[bot]@users.noreply.github.com>
2026-08-25 11:41:44 -07:00
mintlify[bot] 41af0c5388 Update from code changes: remove retired mint deslop command (#7005)
* docs: remove retired mint deslop CLI command

* docs: remove retired deslop API endpoint and references

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-08-18 09:27:39 -07:00
mintlify[bot] e2787cfd93 Apply brand tone and writing style fixes (#6893)
* docs: standardize documentation writing style

* docs: apply brand tone and style fixes

* docs: refine brand tone and writing style

* Revert changelog.mdx changes

The changelog is generated content and shouldn't be rewritten by the
brand tone and writing style pass.

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

* Update ai/model-context-protocol.mdx

* 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>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 16:56:42 -07:00
mintlify[bot] 7c7c11169f Update from code changes: document mint index command (#6884)
* docs: document mint index command

* docs: refine index command translations and SEO

* 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-08-06 09:50:44 -07:00
Ethan Palm ce50a41e23 mint signup visibility components (#6850)
* add CLI visibility components

* add quickstart visibility components
2026-08-03 14:21:13 -07:00
mintlify[bot] 28fdfba3c0 Update from code changes: document mint format command (#6711)
* docs: document mint format command

* docs: translate mint format command to es, fr, zh

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-23 12:13:16 -07:00
skeptrune 5093c9667b Add deslop endpoint to Admin API spec (#6559)
* Add deslop endpoint to Admin API spec

* Document mint deslop CLI command

* docs: add API reference page for deslop endpoint

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-17 16:26:39 -07:00
mintlify[bot] e5d1791438 docs: remove mint analytics CLI command (#6221)
* docs: remove mint analytics CLI command

* docs: tighten CLI page descriptions for SEO

* Apply suggestion from @ethanpalm

* clean up redirects.json

---------

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-18 10:22:10 -07:00
Ethan Palm 490436fda9 use snippet for repeated prompt (#5628) 2026-05-01 11:29:29 -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] 7d4144398d Document mint score default subdomain fallback (#5512)
Generated-By: mintlify-agent

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-04-24 10:47:09 -07:00
mintlify[bot] 1c987f8556 Add mint score command to CLI reference (#5280)
* Add mint score command to CLI commands reference

Generated-By: mintlify-agent

* Add mint score docs to localized files and CLI overview

Generated-By: mintlify-agent

* 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>

* 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-04-13 13:58:43 -07:00
mintlify[bot] d6960c72bf Improve SEO metadata across documentation pages (#5310)
* Improve SEO metadata: fix titles, descriptions, and remove redundant OpenAPI descriptions

- Remove description frontmatter from 19 API pages where the OpenAPI spec already supplies the description
- Fix 2 titles that exceeded 60 characters (content-templates, content-types)
- Improve 15 descriptions that were too short (<130 chars) or too long (>160 chars) to target 130-155 characters
- All descriptions are unique and include relevant search terms

Generated-By: mintlify-agent

* re-add API descriptions

* 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-04-13 09:41:41 -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