为什么要做术语审计

亚星平台在日常使用中会反复出现一批术语,例如“使用教程”“功能”“常见问题”。这些词在团队内部经常被当成约定俗成的简称,但每个人脑子里的定义并不一致。术语审计是指把关键词语逐一取出,写出可核对的定义,再对照当前实际用法找出偏差。又称词条校准,属于一种低成本的内部对齐动作。
之所以现在做,是因为术语一旦含糊,后续的教程编写、功能说明和问题排查都会建立在不同的前提上。审计不追求一次性统一,而是先把差异暴露出来。 亚星平台使用教程
审计范围与词条边界
范围决定审计能不能收敛。建议先划定词条边界,再逐条处理。
- 只纳入会直接影响操作判断的术语,例如与账号、权限、功能入口相关的词。
- 把纯营销描述排除在词条之外,避免定义被形容词稀释。
- 为每个词条标注来源:来自使用教程、功能说明还是常见问题记录。
- 同一术语若在不同来源中含义不同,保留两个词条并注明差异。
- 边界外的词条暂不处理,记录在待议清单,避免审计无限扩张。
使用教程类词条清单
这类词条围绕“怎么用”展开,定义要落到可观察的动作上。
- 使用教程:是指面向新使用者的步骤说明,相关词条包括入门路径与操作顺序。
- 操作顺序:又称步骤序列,指完成一件事所需的先后动作,判断标准是能否按序复现。
- 前置条件:是指开始操作前必须满足的状态,例如账号状态或权限范围。
- 教程覆盖度:指教程是否覆盖了常见分支,判断方式是逐条核对分支是否都有对应说明。
- 过时步骤:指教程中已不再适用的描述,常见信号是步骤与当前界面不一致。
功能类词条清单
功能类词条最容易膨胀,审计重点是边界而不是数量。
- 功能:是指平台提供的可调用能力,相关词条包括功能入口与功能边界。
- 功能边界:又称能力范围,指某项功能明确不处理的情形,判断标准是能否举出反例。
- 功能入口:是指到达某项功能的路径,判断方式是能否在不依赖口头指引的情况下找到。
- 功能重叠:指两项功能在效果上部分重合,需要注明各自适用场景。
- 功能依赖:指某项功能生效需要另一项功能先开启,属于常见问题的高发点。
常见问题类词条清单
常见问题类词条的价值在于把重复提问转成可复用的定义。
- 常见问题:是指被反复提出的疑问集合,相关词条包括问题分类与排查顺序。
- 问题分类:又称归因分组,指按账号、权限、功能等维度划分问题。
- 排查顺序:是指从最可能原因开始验证的次序,判断标准是每一步都能得出是或否。
- 已知限制:指当前不打算解决的问题,需要与缺陷区分开。
- 复现条件:是指让问题再次出现的最小操作集合,是判断问题是否解决的关键。
危险信号与整改顺序
审计过程中出现以下信号,说明术语已经影响使用。
- 同一术语在教程与功能说明中指向不同对象。
- 常见问题记录里出现“按教程做了但结果不同”的描述。
- 功能入口只有少数人知道,且没有文字记录。
- 词条定义里出现大量程度词,却举不出可核对的例子。
整改顺序建议从使用教程类词条开始,再处理功能类,最后收敛常见问题类。每轮只改定义与例子,不改平台本身,确保审计结果可被下一轮核对。
