Commit Graph

13 Commits

Author SHA1 Message Date
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
Ethan Palm 67af10ce48 fix links (#5370) 2026-04-14 17:47:25 -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] 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
mintlify[bot] 8856d53912 Add guide for configuring GitHub App automerge (#4452)
* Add guide for configuring GitHub App automerge

Generated-By: mintlify-agent

* copy edit

* move to AI section

* Update index.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-13 17:29:26 -07:00
Ethan Palm 29aba2f38b Add headless guide (#3514)
* Add custom frontend use case guide

Documents the @mintlify/astro integration for building custom
documentation frontends. Covers setup from the starter repo,
how the integration works, and connecting search/assistant.

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

* Fix Vale errors and broken link in custom frontend guide

Add Astro to Vale vocabulary, fix em dash spacing, and remove
broken /ai/search link.

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

* Add custom frontend link to guides index

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

* Fix Node.js version requirement to v20.17.0+

Matches the Mintlify CLI minimum requirement.

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

* create custom frontend guide

* Rewrite setup steps to match actual onboarding flow

* copyedit

* reviewer feedback

* add image of repo settings

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 08:10:02 -08:00
Ethan Palm 99550b688b Add linking and references guide (#2836)
* Update guides/linking-and-references.mdx

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

* Update docs.json

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

* copy edit

* add to guides index

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-01-23 16:59:45 -08:00
Ethan Palm 872b9f923d Use case guides: support center and developer docs (#2727)
* update vale vocab

* add new guides to docs.json

* update guides overview

* create support center guide

* add dev docs guide

* vale
2026-01-16 09:48:06 -08:00
Ethan Palm b3974550ae Add i18n guide (#2587)
* add i18n guide

* combine with agent PR
2026-01-08 12:02:09 -08:00
Ethan Palm 8bbf5083fb Add content templates (#2569)
* add templates

* update supporting docs

* update reference template
2026-01-07 10:12:26 -08:00
Ethan Palm d7e453d744 Knowledge base guide (#2039)
* add Use cases group

* Create knowledge-base.mdx

* add outline

* draft

* update guides overview

* update introduction

* update intro with assumption of migrating

* reorganize

* concision

* copyediting

* copyedits

* copyedit

* missing punctuation

* use Steps

* shorter heading
2025-12-03 19:55:58 -08:00
mintlify[bot] 287d71a8c2 Fix grammar issues in guides (#2017)
* Update guides/index.mdx

* Update guides/accessibility.mdx

* Update guides/media.mdx

* Update guides/style-and-tone.mdx

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2025-12-03 09:59:43 -08:00
mintlify-development[bot] a551b3c3c0 Add guides overview page (#1950)
* Update guides/overview.mdx

* Update docs.json

* copyedits

* Update index.mdx

* update title

---------

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-01 11:21:43 -08:00