Commit Graph

11 Commits

Author SHA1 Message Date
mintlify[bot] e3a8948aa8 docs: fix voice and terminology consistency in SDK examples page (#7249)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
2026-09-03 17:46:57 -07:00
mintlify[bot] eda7fa06cb docs: use consistent "automated code sample URL" term on SDK examples page (#7247)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-09-03 23:39:29 +00:00
Ethan Palm 160e74aa0f Remove stainless, fix speakeasy (#7246)
* Remove Stainless integration page and fix Speakeasy config examples

Stainless was acquired by Anthropic (announced 2026-05-18) and wound down
all hosted products, including the SDK generator: "new signups, projects,
and SDKs will not be available." The integration page documented a
hosted-platform flow (Studio -> Release tab -> Setup OpenAPI publishing)
that no new reader can complete, so it is removed and redirected to the
vendor-neutral x-codeSamples page.

Speakeasy is still operating and the integration still works, but its
docs.json examples used the pre-docs.json schema (top-level "anchors"/
"tabs" keyed on "name"/"url"). Updated to the current navigation.anchors
/ navigation.tabs shape so the snippets are copy-pasteable.

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

* Collapse Speakeasy page into the Add SDK examples page

With Stainless removed, the Integrations > SDKs group held a single page.
Fold the Speakeasy setup steps into api-playground/adding-sdk-examples.mdx
as a "Generate examples with Speakeasy" section and drop the group.

The page now covers both routes to x-codeSamples: writing samples by hand
and pulling autogenerated ones from a Speakeasy combined spec. Old page
paths redirect to the new section anchor.

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

* Apply batched suggestions from code review

Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>

* use steps

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-03 16:36:29 -07:00
mintlify[bot] 629f648c57 Apply brand tone and writing style fixes (#6720)
* docs: apply brand tone and writing style fixes

* docs: split long sentences in self-host page

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-07-24 11:35:09 -07:00
mintlify[bot] 21abbffaa1 docs: tighten four overly long sentences for readability (#6116)
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2026-06-08 11:25:19 -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-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
Ethan Palm 30d7e22acf Flatten "Document APIs" group (#1752)
* consolidate MDX group into single page

* update nav and redirects

* match filename to title

* revise intro and setup

* update auth section

* remove outdated intro

* copyedit overview

* add link to example endpoint page

* remove asyncapi subdirectory

* 💅

* move MDX content out of OpenAPI setup

* copyedit openapi-setup

* Revert "move MDX content out of OpenAPI setup"

This reverts commit 3baed8e572.

* copyedit mdx-setup

* clean up openapi-setup

* task-based title

* fix title

* copyedit manage page visibility

* 💅

* update descriptions

* fix title

* add missing keywords

* fix YAML
2025-11-17 15:51:49 -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
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