G1.08.3glossary covers UI docs search设计研究

术语表需覆盖界面、文档与检索

别名: 术语表覆盖 · three-channel glossary · 界面文档检索

概念解释

只把首选词写进导航,帮助中心、发布说明、搜索同义词和客服话术仍各用各的,术语表就是一张没接上系统的表格。术语表要覆盖界面、文档与检索:同一概念在按钮上、在说明里、在索引里指向同一个节点。缺任一通道,用户会在通道切换时重新学习,或用文档里的词去搜界面上不存在的名字。

覆盖不是三份拷贝,是一份词表被三个通道消费:界面取首选词,文档取首选词加必要的法定名,检索取首选词加别名。

机制

人跨通道转移用词。看完帮助里的「工作区」,会到产品里找「工作区」;在产品里学会「项目」,会把「项目」键入搜索。通道之间若各有词表,转移失败,看起来像功能找不到,根因是词没跟着人走。客服与机器人若读的是第四套词,对话记录无法回链到界面对象,问题会被当成新需求。

检索通道尤其容易被落下:界面词表由设计维护,帮助由内容维护,同义词表由搜索工程维护。三套更新不同步,最新的改名只活在其中一个通道里。

怎么研究

做跨通道的词跟踪,而不是审阅单一词表文件是否好看。

  • 范式:选定核心概念,在界面字符串、帮助与发布说明、搜索同义词配置里抓取用词,做对齐矩阵;任务上让人从文档句子出发去产品里找对应控件,或用界面学到的词去搜。
  • 自变量:词表是否单一数据源、改名是否同时推送到三通道、文档是否允许保留旧法定名。
  • 因变量:跨通道用词分裂数、从文档到界面的定位成功率、用界面词检索的召回。
  • 方法论注意点:抽查首页和主帮助文章会高估覆盖。要抽改名之后的边角页面、邮件模板、错误码说明。自动化字符串比对能发现字面分裂,共指仍需人工。

边界

对外法律文本必须保留法定表述,文档通道可以出现正式名,但要链回界面首选词,不能让法律文本去改按钮。第三方集成的错误信息不受本词表控制,应在包裹层翻译成首选词,而不是要求对方改。开源与社区贡献的文档会滞后,覆盖要有「社区副本允许旧词、官方通道必须新词」的分层,而不是假装全球同时切换。

怎么落地

  • 词表做成三通道的共同数据源,改一个首选词,导航、帮助与搜索配置一起出变更。
  • 发布检查单包含:界面文案、帮助检索、同义词、邮件与错误提示,四处抽同一概念。
  • 文档若必须出现旧名或法定名,用一次对接句,之后回到首选词。
  • 验证:从一个概念的帮助段落里抽出用词,拿到产品里找控件、拿到搜索框里查。三处对不上同一对象,缺的就是那个通道,不是「文案风格」问题。

延伸

  • 同组G1.08.1 术语不一致会被理解为功能差异 · G1.08.2 同义词需要映射而非并存
  • 相邻G1.10 受控词表与同义词 · T1.04 术语一致性与词汇表 · T3.02 帮助内容的组织与检索
  • 站内检索glossary coverage · terminology management · search synonyms

同组卡片

快捷操作

分享

分享当前页面

ios_share

https://hci.top/zh/handbook/G1.08.3