Repository navigation
Use one set of terms across the console and docs - #701
Merged
Merged
Conversation
Providers are 提供商 (沙箱提供商, 模型提供商), Environment stays an API term, templates are 模板, and stray spaces between Chinese words are gone. The Plain Vocabulary Rule in DESIGN.md and PRODUCT.md now names these terms for the zh copy and the zh docs alike.
Nothing outside their own tests called agentNeedsCredentialCatalog, deriveSessionVaultPlan, loadVaultCatalog or matchingCredentials, so they go with their tests, the error copy only they used, and the top-level collection pager only the catalog needed.
The zh docs now name pages and actions exactly as the zh console does, call project keys 项目 API 密钥, and use 项目, 沙箱提供商, 模型提供商, 提供商, 模板, 主机 and 子 Agent throughout, without gloss headings or stray spaces.
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
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.
What
This is Part 1 of UX polish lane E: one set of terms across the console and the docs.
legacyHashesis gone fromlib/console-routes.ts, along with its test cases. Old hashes such as#builder,#playgroundand#api-keysnow open the Overview. Copy with no caller is deleted: 423 keys, including 58 unused zh sandbox entries, plus the unuseddashboardnamespace. The unused Vault catalog helpers (agentNeedsCredentialCatalog,deriveSessionVaultPlan,loadVaultCatalog,matchingCredentials) are deleted with their tests, their error copy and the top-level collection pager only they used.apps/web/.impeccablenotes.README.zh-CN.md. The zh site landing copy follows too.contracts/agents-api/zh/sessions-events.mdsays Session and Item instead of 会话 and 条目.source_hashvalues are refreshed for every changed English source.apps/web/PRODUCT.mdand the Plain Vocabulary Rule inapps/web/DESIGN.mdrecord the decisions for the zh copy and the zh docs alike.Why
The UX review found the same concept under two or three names, often on one screen, e.g. 运行时历史 next to Runtime 历史, and API key next to API 密钥. Docs and Web also named the same things differently. Unused copy made each sweep longer and hid real leftovers.
Verification
pnpm --filter @oac/web typecheckvitest runacross all of apps/web, because the pruned copy is shared: 71 files, 381 tests passed.chromechannel:diagnostics,overview-readiness,sandbox-generation,wording,sandbox-lifecycle,sandbox-reset,sandbox-rollout-details,resourcesandaccess, 49 passed. Earlier round:nodes,resourcesandprovider-observations, 18 passed.pnpm --dir website check-translations,make check-docsandmake check-names.--zhover the zh docs.Skipped
make check, per lane rules.Merging with #702
Whichever of #701 and #702 merges second gets small conflicts with adjacent lines:
apps/web/PRODUCT.md(Terminology line),apps/web/e2e/diagnostics.spec.ts:57,en/sessions.tsandzh-CN/sessions.ts, anddocs/zh/web/index.md(itssource_hashand the Sandbox metrics row). Resolve each by keeping #702's structure (its locators, Status copy, Sandbox metrics row andsource_hash) and #701's terms (e.g. 模型提供商认证失败, the Terminology line).