鸿蒙综合讨论/S14 对齐:与上游功能的映射表

S14 对齐:与上游功能的映射表

移植标准 S14:对齐——与上游功能的映射表

「Air 系列移植标准」第十四篇,收官:S14 要求维护一张与上游版本的功能映射表——移植版与桌面版的能力对齐情况,逐项可查。

▍定义
映射表三列:上游功能项(桌面版的全部功能清单)、移植状态(对齐、部分对齐、替代实现、裁剪)、说明(差异的具体内容——部分对齐差在哪、替代方案是什么、为什么裁剪)。表随版本更新,与工程文档同寿命。

▍为什么重要
用户的第一个问题是它跟桌面版比怎么样(映射表是唯一诚实的答案——没有它,答案变成营销话术或含糊其辞);开发的方向盘(差什么、差多少、优先补什么——表就是待办清单的骨架);信任资产(如实标注差距的团队,用户信你说的能做到——夸大标注的团队,做到的也没人信)。

▍达成要点
功能清单的完整性(上游功能的穷举——菜单、面板、对话框、命令、格式支持,逐级展开到叶子);状态判定的诚实(部分对齐要写明缺什么——最伤信任的是把部分标成完整);替代实现的说明(移动形态的等价物:独立窗改标签页是替代不是缺失——说明等价关系);裁剪的理由(为什么不做——技术上不可行、体验上不合适、排期未到,三种理由三种表述)。

▍自查方法
表的完整性核对(拿上游文档与界面逐项过——漏项最多的地方往往是没测的地方);每项状态的实测抽查(标了对齐的真的对齐吗——抽查测试);用户视角的呈现(映射表转化成用户能懂的说明——发布说明与帮助文档的素材源)。

▍常见不达标形态
没有表(对齐情况全靠开发者记忆——人员一换就失忆);表是摆设(状态标了没人验——抽检就穿帮);只写缺的不写替的(替代实现的功能被误读为缺失)。

▍一句话
S14 是整个标准系列的账本:前十三项做得怎么样,映射表说了算。诚实是这份账本的唯一记账原则。

免费无广告的安装包可以在官网下载体验。
楼主 7 天前
想参与讨论?登录 或 30 秒注册。