docs: Update UI terminology and improve navigation instructions#931
Open
docs: Update UI terminology and improve navigation instructions#931
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
- billing.mdx: "Upgrade & Billing" -> "Billing" to match portal sidebar - delete-account.mdx: "Custom Domain tab" -> "Custom Domains section" - managing-project-members.mdx: "Members tab" -> "Members & Access section" https://claude.ai/code/session_01UNjsk94xEitp7p3ewdtpRh
- source-control-setup-github.mdx: "Settings tab" -> "click Settings" - custom-ci-cd-github.mdx: Clarify "account Settings > API Keys" https://claude.ai/code/session_01UNjsk94xEitp7p3ewdtpRh
- testing-graphql.mdx: "API test console tab" -> "Code" nav + test console - step-1-setup-basic-gateway.mdx: Remove "tab" from "Settings tab" - step-4-deploying-to-the-edge.mdx: "Settings tab" -> "click Settings" https://claude.ai/code/session_01UNjsk94xEitp7p3ewdtpRh
- custom-domains.mdx: "Custom Domain" -> "Custom Domains", remove "tab" - developer-api.mdx: "click gear icon" -> "account Settings > API Keys" - environment-variables.mdx: "Settings tab" -> "click Settings" https://claude.ai/code/session_01UNjsk94xEitp7p3ewdtpRh
- api-key-api.mdx: "Settings > Project Information" -> "Settings > General" - mcp-server.mdx, openapi.mdx, url-forward.mdx: "Files tab" -> "Code tab" https://claude.ai/code/session_01UNjsk94xEitp7p3ewdtpRh
Navigate to Projects > New Project instead of directly clicking "Create New Project" from the dashboard. https://claude.ai/code/session_01UNjsk94xEitp7p3ewdtpRh
ntotten
force-pushed
the
claude/update-portal-docs-hpTh6
branch
from
5587cae to
b20e47a
Compare
- Project creation: no "AI Gateway" template exists; user must click "AI or MCP Gateway" link at bottom of the New Project dialog - App creation: "Model" field is actually split into "Completions" and "Embeddings" model selectors - App creation: submit button says "Create App" not "Create" - Team creation: limits are configured after creation via the "Usage & Limits" tab, not during creation via "Settings" Verified with Stagehand + Playwright against portal.zuplo.com. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add Stagehand-powered test scripts next to each doc that contains
portal UI instructions. Tests authenticate to the real portal and
verify navigation steps, button labels, form fields, and UI structure.
Test files:
- docs/ai-gateway/getting-started.test.ts
- docs/ai-gateway/managing-{providers,teams,apps}.test.ts
- docs/ai-gateway/usage-limits.test.ts
- docs/handlers/{openapi,redirect}.test.ts
- docs/articles/{custom-domains,environment-variables}.test.ts
- docs/articles/{source-control-setup-github,rename-or-move-project}.test.ts
- docs/articles/step-{1,4}-*.test.ts
Shared harness: scripts/lib/portal-test.ts
- Stagehand v3 (LOCAL) + Playwright CDP for auth injection
- Uses addInitScript to inject ROPC tokens before Auth0 redirect
- AI-powered verification via act/extract/observe
- Screenshots saved to *-screenshots/ dirs (gitignored)
Run any test: npx tsx docs/ai-gateway/getting-started.test.ts
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Handler tests: use Playwright to open dropdowns and extract options directly (Stagehand only extracted the currently-selected value) - Settings tests: use Playwright link extraction via getSettingsLinks() helper (Stagehand returned cryptic IDs for custom sidebar components) - Add getSettingsLinks() to shared portal-test harness - Increase auth timeout from 30s to 60s for stability - Fix getting-started test to use observe() for AI/MCP Gateway link All tests now pass: - openapi.test.ts: 7 PASS (all handlers verified) - redirect.test.ts: 1 PASS - rename-or-move-project.test.ts: 2 PASS - source-control-setup-github.test.ts: 2 PASS - environment-variables.test.ts: 2 PASS - step-4-deploying.test.ts: 2 PASS - custom-domains.test.ts: 2 PASS - managing-apps.test.ts: 3 PASS - managing-providers.test.ts: 3 PASS, 1 WARN - managing-teams.test.ts: 6 PASS, 1 WARN - usage-limits.test.ts: 5 PASS Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR updates documentation across multiple articles to reflect current UI terminology and improve clarity of navigation instructions in the Zuplo portal.
Key Changes
Notable Details
All changes are documentation-only and reflect the actual current state of the Zuplo portal UI. The updates improve consistency in how navigation is described across the documentation and make instructions clearer for users.
https://claude.ai/code/session_01UNjsk94xEitp7p3ewdtpRh