术语表与统一语言是什么
术语表把业务与技术共享的概念固定成一份可查词条:术语、定义、别名、所属领域、维护人。它解决的是协作中最隐蔽的损耗——同一个词在不同团队指不同东西,或者同一件事有多个叫法。词条还必须处理「一地一义」:当同一术语在多个系统含义不同时,要写明差异与消歧规则,否则统一语言只统一了名字,没有统一含义。
基本信息
| 内容 | 术语、定义、别名、所属领域、维护人 |
|---|---|
| 价值 | 减少歧义、支撑检索、辅助新人理解 |
| 维护 | 新术语先查重后新增,定期合并同义项 |
| 查重 | 新增前先搜别名,避免同义多词条 |
| 引用 | 文档首次出现术语处加链接,读者可随时查证 |
典型使用场景
- 需求评审反复澄清同一个词,说明定义未统一
- 同一对象在多个系统有不同名称,报表对不上口径
- 新人读文档时被内部简称卡住,需要集中查阅入口
- 跨部门协作中旧叫法与新叫法并存,沟通成本上升
- 知识库检索命中率低,需要用别名把口语叫法接进来
词条示例
词条示例
术语:结算单 # 术语用现行正式名称
定义:按账期汇总的应收凭证 # 定义要能界定边界,别用举例代替定义
别名:账单 / statement # 覆盖新旧叫法与英文表述
反例:单笔订单不算结算单 # 反例最能消除误解
领域:财务结算 # 领域决定消歧范围
维护:结算产品组 # 争议时有明确的拍板人词条字段
| 字段 | 作用 |
|---|---|
| 别名 | 覆盖新旧叫法便于检索 |
| 反例 | 说明什么不算该术语 |
| 维护人 | 争议时有人拍板 |
| 变更记录 | 叫法迁移时保留旧称指向新词条 |
| 关联词条 | 说明与相邻概念的差别,减少混用 |
术语表只有被搜索到才有价值:别名要覆盖口语与旧称,文档里首次出现术语的位置要挂链接,否则读者会在需要它的那一刻找不到入口。