Skip to content

Add code samples for all endpoints, update designs - #339

Merged
mnemitz merged 3 commits into
mainfrom
speculoos/1-site-fixes
Nov 3, 2026
Merged

mnemitz merged 3 commits into
mainfrom
speculoos/1-site-fixes

Conversation

@mnemitz

@mnemitz mnemitz commented Nov 3, 2026 •

Copy link
Copy Markdown
Collaborator

This was previously reviewed in #336 and #335

mnemitz and others added 3 commits November 2, 2026 15:34
- The page body fills its width: its Box was a flex child with no width,
  so it shrank to its content and the layout jumped from page to page.
- Type errors in LinkCard, Tabs and remark-admonition. The controlled
  Tabs root drops a defaultValue that Radix ignores.
- Radix Code drops Infima's leftover border and vertical-align once, in
  reset.css, rather than inline in CodeInline; inline code and
  admonitions use the outline variant.
- The Management API's path is /v1/api-keys in the temporary key
  examples; a guide's link to the Realtime reference drops its .mdx.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
**Stack 2 of 4**, splitting #331 for review. Based on #334.

1. Site fixes (#334)
2. **Management reference from the public spec** ← this PR
3. Code samples, tested against a mock
4. API reference on Speculoos

## Changes
- **`spec/mp.yaml` is the public spec generated upstream** (`make
public-spec` in the Management Platform repo). It's OpenAPI 3, and it
already includes what this repo's old Swagger 2.0 copy added: the
server, authentication (a management token everywhere; either a token or
an API key on `POST /api-keys`), and the descriptions and summaries.
- **`generate-mp-spec.ts` reads it as OpenAPI 3.** The spec names its
own server, so the generator no longer sets `basePath`, and schema
titles go on `components.schemas`. The code-sample loop goes: there were
no Management samples, and PR 3 adds them through one shared injector.
- **One page is renamed by the new summaries:** `post-a-new-project` →
`create-a-project`, with a redirect and the link in `projects.mdx`
updated. I compared the generated page list with `main`'s, and nothing
else changed.

The pages still render through the current OpenAPI plugin. Most of the
spec diff is upstream's generated output; the review points are the
generator and the redirect.

## Checked
- `npm run build` passes, with no broken links.
- The request schemas are in the generated pages. The plugin renders
them client-side, as it does on the live site.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Nov 3, 2026 4:16pm UTC

Request Review

@mnemitz
mnemitz merged commit ee938a9 into main Nov 3, 2026
1 check passed

This branch was successfully deployed

1 active deployment
Preview — 02209ed7 Deployed Nov 3, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant