Repository navigation
docs(contracts): bring the zh sharing close to the measured parent reach (#881) - #893
Merged
Merged
Conversation
…ach (#881) The closing paragraph of the *Sharing* section on `content/docs/revenue/contracts.mdx` was rewritten in #699 (0899b4f) against the reach measured in #694: neither route an admin can take actually delivers "contracts follow the account" today — a sharing rule on Contract widens the records it matches for every holder of the object, and a Controlled-by-Parent OWD derives org-wide in this release, the parent link not being consulted per caller. That commit touched the English page only. Both Chinese pages stayed on the pre-correction text, which said the two routes merely "open contract visibility to every user of the object" and omitted the conclusion the correction exists to deliver. `contracts.zh-Hans.mdx` and `contracts.zh-Hant.mdx` now carry the same three facts as the English page, and cite the *Controlled by Parent, in practice* section by its translated heading — “由父级控制”在实践中 / 「由父層控制」在實務中 — on top of the page-level link they already had. No new anchor link: the translated headings do not slugify to the English anchor, so the zh pages keep the un-anchored form used since #868, and the English page cites that section as plain text as well. Translation only — no new assertion beyond what the English page states. No English page, metadata, profile, sharing-rule or OWD change; the reach being described stays pinned by `test/parent-derived-reach.test.ts`. The first two bullets of the same section, rewritten in #878, are untouched. Fixes #881
|
The latest updates on your projects. Learn more about Vercel for GitHub. |
Collaborator
Author
|
正文在一次 body 更新中被平台去掉了归属页脚(创建时是有的),补在这里: Generated by Claude Code |
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.
Fixes #881
content/docs/revenue/contracts.mdx「共享」小节的收尾段在 #699(0899b4f7)里按 #694 的实测结论重写过,但那个 commit 只动了英文页。两份中文页停在改写之前,中文读者拿到的是纠偏之前的口径。本 PR 只补这一段的两份译文。前提复核(基线
origin/main=c94a35c7)三份页面的
git log对照,成因与 issue 的判断一致:0899b4f7content/docs/revenue/contracts.mdxcontent/docs/revenue/contracts.zh-Hans.mdxcontent/docs/revenue/contracts.zh-Hant.mdx#694/#699的事实在英文页仍在(contracts.mdx:155),test/parent-derived-reach.test.ts仍在钉住实测可达范围,上游objectstack-ai/objectstack#5386仍 open。前提成立。en / zh 差异表(改前)
英文页
contracts.mdx:155现行有、两份中文页:155没有的四处:译文对照
zh-Hans(
contracts.zh-Hans.mdx:155)zh-Hant(
contracts.zh-Hant.mdx:155)只翻既有英文事实,不加新断言:改后四个分句与英文页
:155的四个分句一一对应,没有引入英文页没说的东西(没有新增测试数字、没有新增 issue 号、没有新增行为承诺)。用词:简体按
src/translations/zh-CN.ts与本页既有惯用词(合同 / 字段 / 对象 / 共享规则 / 派生 / 调用者 / 父级链接 / 组织范围,均与sharing-and-security.zh-Hans.mdx一致);繁体按本页既有惯用词(合約 / 欄位 / 物件 / 共用規則 / 衍生 / 呼叫者 / 父層連結 / 組織範圍,与sharing-and-security.zh-Hant.mdx一致)。引号沿用两页各自的既有写法:zh-Hans 页正文用「」,而「由父级控制」这个术语在全仓 zh-Hans 页(sharing-and-security.zh-Hans.mdx的小节标题、profiles.zh-Hans.mdx的引用)一律写作 “由父级控制”,改前那一行也是如此,故保持不动;zh-Hant 全用「」,无此分歧。小节引用按 zh 页既有写法:不新增带锚站内链接。两页的翻译标题(“由父级控制”在实践中 / 「由父層控制」在實務中)不会 slugify 成英文锚点,PR #868 已为同类情形定下「zh 页链接到页面、锚点去掉」的先例;这里在既有页面级链接之后补一个纯文本小节名,与
profiles.zh-Hans.mdx:45/profiles.zh-Hant.mdx:45已在用的写法逐字一致。英文页自己引用这一小节时也是纯文本,不带锚。与 #878 的衔接
0550c5fb(#878)改的是同小节的前两条 bullet(合同所有者的「读 vs 编辑」两层、Sales Manager / System Administrator 是仅有的两个持有编辑权的 profile),收尾段它没碰。本 PR 只改收尾段那一行,git diff每份文件各 1 行增删,#878 与 #874 落的内容逐字节未动,零回退。语义上也不重复:前两条 bullet 讲「谁读得到、谁改得动」,收尾段讲「想让它跟随账户该怎么办、以及为什么两条路都不成」。同批漏页核查(只核不改,结论:无漏页)
0899b4f7的文件面里另有两份文档页。逐段比对英文页与两份中文页后,两份都已补齐,无需再改:content/docs/administration/sharing-and-security.mdxa98ddaa4(#790 / #791 → PR #811)content/docs/administration/profiles.mdxcc25f6d9(#807 → PR #820)0899b4f7触及的其余文件是src/**注释与test/sharing-coverage.test.ts,没有中文对应页。因此本条不产生 out-of-scope finding。验证
全量套件在共享锁下依次跑过,均为退出码 0:
pnpm validate✓ Validation passed (4619ms)pnpm typechecktsc --noEmit无输出pnpm build✓ Build complete (1566ms)·Artifact: dist/objectstack.json (1921.4 KB)pnpm test -- --maxWorkers=2Test Files 66 passed (66)·Tests 1587 passed | 1 skipped (1588)pnpm lint13 warning(s), 14 suggestion(s) (1231ms)(均为既有告警,与本改动无关)node scripts/check-source-hygiene.mjs✓ source hygiene clean(406 个content/.changeset文件纳入控制字节扫描)pnpm test输出里✗ source hygiene failed …若干行是 source-hygiene 元测试自身故意构造的失败样本打到 stderr 的,属预期,测试文件全绿。docs-drift.test.ts的中英文 callout 数量校验不受影响:本 PR 没有增删任何 blockquote 引用块。改动文件的控制字节自扫(
grep -naP扫\x00-\x08、\x0b、\x0c、\x0e-\x1f)零命中。changeset
.changeset/contracts-zh-sharing-sync.md(hotcrm: patch),站内路径用反引号。