Skip to content

[观察] guides/search-and-navigation 的「内置视图随系统提供」把两种来源的视图说成一种:商机 9 个是本应用自己声明的,审批 4 个才是插件随系统带的 #982

Description

@yinlianghui

#973 / PR #979 的实施里分出来的概念表述问题——#973 的正文已把它列为「顺带可核」,并建议与例子分开判断;#973 由 PR #979 关闭后这条记录会随之消失,所以单独存档。

基线 origin/main = 01da4a8e(平台 17.0.0-rc.3)。

事实

content/docs/guides/search-and-navigation{,.zh-Hans,.zh-Hant}.mdx 的《内置 vs 个人 vs 共享》第一条:

- **Built-in** views ship with the system — …
- **内置**视图随系统提供——…
- **內建**檢視隨系統提供——…

PR #979 只换掉了这一句举的例子(两个幻影名换成真名),「随系统提供」这半句没动。它把两种来源混成了一种:

视图 来源
Open Deals / All Opportunities / My Deals / Pipeline / Forecast / Timeline / Cards / Stale / Closing Soon src/views/opportunity.view.ts——本应用自己声明的元数据,随这个 app 走,管理员改得动
My Pending / I Submitted / Completed / All @objectstack/plugin-approvalssys_approval_request.listViews 上内置——平台插件随系统带的,装了插件就有

为什么可能不要紧

对本页读者(业务用户)而言,「随系统提供」要说的是「不是你自己建的」——这一点两类视图都成立,所以今天没有任何用户会因为这句话找错东西。这是它被判为观察级、不带 pm:queue 的原因:没有可复现的用户影响,只有一处开发者口径上的不精确。

为什么仍值得记

同一页的《个人 / 共享》两条讲的是「用户自己建、可共享」的视图,跟这一条对照着读。如果将来要把三类视图的边界写准(例如管理员能改哪些、升级插件会覆盖哪些),「随系统提供」这句就得先分清是「随 app 走」还是「随插件走」——那时这条是起点。

边界建议

  • 面:仅这三份文件同一条 bullet 的前半句;例子部分已由 PR docs(guides): name real built-in views in search-and-navigation (#973) #979 写实,不要重开。
  • src/ 零改动;若改动落地,test/docs-search-navigation-views.test.ts 是这条 bullet 现成的守卫位置。
  • 本页其余段落(快捷键表、批量操作清单、应用启动器列出的三个应用)本次未复核,不在本单主张范围内。

Refs #973 #979

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationfinding

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions