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,578 Commits 1,654 Branches 0 Tags
testing2
Commit Graph

37 Commits

Author SHA1 Message Date
mintlify[bot] 27134fcb4e Documentation quality check: fill reader-question gaps on 3 pages (#6571) 
* docs: address reader-question gaps in custom scripts, seo, and settings reference

* docs: translate custom scripts, seo, and settings reference edits to es/fr/zh

* Update organize/settings-reference.mdx

* Update customize/custom-scripts.mdx

* fix code fence

* 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-15 10:40:13 -07:00
mintlify[bot] 74aa617407 docs: close unterminated code fence in optimize/seo.mdx (#6565) 
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-07-14 22:45:09 +00:00
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] ed3a2e4799 Update from code changes: document seo.trailingSlash option (#6533) 
* docs: document seo.trailingSlash config option

* docs: wrap translated trailingSlash headings with anchor divs

* 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-14 14:56:54 -07:00
mintlify[bot] ef8659c0eb fix: correct sentence punctuation in SEO indexing note (#6555) 
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-07-14 17:43:03 +00:00
Ethan Palm 20bfad9ddf 💅 2026-07-14 10:38:14 -07:00
Ethan Palm 6aca45ca9d docs: document automatic structured data (JSON-LD) generation 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-14 10:12:51 -07:00
mintlify[bot] 54f9721835 Apply brand tone and writing style fixes (#6532) 
* docs: apply brand tone and writing style fixes

* 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-07-13 16:31:33 -07:00
mintlify[bot] e015e2d19e Vale style audit: fix warnings from PRs merged in the last week (#6278) 
* docs: fix Vale warnings from PRs merged in the last week

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

* 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-06-25 09:24:44 -07:00
mintlify[bot] a6ec4be434 docs: fix Vale warnings from PRs merged in the last week (#6222) 
* docs: fix Vale warnings from PRs merged in the last week

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

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-06-18 10:09:09 -07:00
mintlify[bot] c53752118c docs: document project-level noindex setting (#6152) 
* docs: document project-level noindex setting

* docs: wrap translated noindex headings with anchor divs

* 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-11 11:37:11 -07:00
Dean from Mintlify 485d8b0828 Improve SEO metadata clarity in optimize/seo.mdx (#6008) 
Mintlify-Source: dashboard-editor
 2026-05-27 13:25:47 -07:00
mintlify[bot] f965fb35de docs: document Content-Signal directives in auto-generated robots.txt (#5966) 
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
 2026-05-26 15:49:51 -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
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] 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
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] 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
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
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] 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 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
mintlify[bot] 2c044765c1 Clarify og:image behavior in SEO documentation (#1464) 
* Update optimize/seo.mdx

* move note

---------

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-06 13:08:56 -07:00
Ethan Palm 654d533b90 Task based IA (#1353) 
* implement task-based IA

* rearrange pages

* tag examples

* add cookbook example

* add a components menu

* rename cookbook to guides

* fix docs.json after adding translations

* prettier docs.json

* move content to Guides

* move GEO page to guides

* draft of ai-native page

* update body with info on reading/distributing

* copy edits

* 💅

* move guides above API reference

* remove CLI sidebarTitle

* update organization

* remove tags

* remove guides icons

* Update ai-native.mdx

* Update ai-native.mdx

* copyedits

* 💅

* even number of cards

* update discovering section

* remove components tab

* remove icons

* remove icon

* add group level icons

* update Get started group

* Update organize group

* update customize group

* update create content group

* shorten URLs

* update API group

* update deploy group

* update optimize and guides groups

* set up redirects

* update links

* add pdf page

* add missing icons

* remove default expanded state

* update docs.json
 2025-10-01 11:55:34 -07:00