当前位置: 首页> 实战营销

分版本注释法:如何迭代你的产品文档更省成本?

发布时间:20-03-23

因♯♮一直使用Axure来写写画画产品文档,就借℡Axure来说明,如何迭代〥产品文档更省成本。

设计产品,自然不仅是画图,更ψ重要的是框定规则,而规则,通过注释的方式展示给团队或客户。相信Axure自带的注释功能远不能满足我≈们⿷产品人员的需求,于是网上经常能看到类似这样的一些注释方式:

这样┖注释,很直观,方便查看,不容易缺漏,也相对容易维│┃护,然后,我们要改需求щ了,开始设计下一个版本,于是通过注释告知团队改了什么:

好,℉问题来了,随着版本一个一个又一个迭代,需求新增或变来又变去,每当你◙设计新ↀ版本时Ⅺ,你需要查看以前的文档吧?可文档就散落在那里∽,你还没法一下子查询所有原型Ш内的内容,你需要整理,整理成一份文档,把所有历史中虽有贡献但过雨云烟的需求剔除掉,把所有还在贡献的需求都整到一份文档里——可产品狗生的价值压根不在这里▶!

更伤心的是≌,除了你自己需要々这样一份时时保持最新完整的文档,还有其他人啊:

新来的:“△让我看下文档,了解下先…”

开发:“这个需求在哪里,什么时候做的?有过吗?”

BOSS:“你这个没∝写过吧?”“在哪里?”“我没空┙看,你跟我直接说吧!”

回到苦逼的自己:“这个需求我写过的,我查查&#℡8230;”“呃,一下子没找到,再等下…”“好吧,我漏了,文档又bug了…”

—————————————— 这★里&需要分割线 ——————————┝︴————

我们来定『两个条件Ⅵ:

第一,所有新版的需求都需要注释标明,小到文案修改∴或布局调整,大到功能添加,都需要明确注释标明给团队; 第二,无论多少个历史版本,其需求对新版本来说都是Ⅷ不太关心的,那么只需要能区分出新版本的注释即可。

那么:我们给Axure这样的设计工具Ↄ新增一个注释╟区分的功能,比如可以约定蓝色为历史版本注释,红色为新版本注释(每次迭代新版本前更新上一版本的ξ注释颜色为蓝色),以此,所有版本的需求和对应注释都可以在一个〾文档里ы写明,又可以通过颜色明确的区分!

这就是分版本注释法,效果大۞概是这样的:

A๑x※ure|︴()〔〕需要支持的功能:

可以给注释打上颜色 生成的HTML中,可以通过颜色筛选出含有对应注释的页面,并在页面中筛选出对应注释,这样就知道了对应※版本改动了哪些页面,以及页面中改动了什么内容

结语:

相信“分版本注释法”实现的“一个原型迭代所有版本”,能够为产品人员Ч省γ去不少Ⅲ写文档的成本,查无缺漏减少bug,进而降低整个产品研发团队的出错几率◄。

P.S. Axur☞e本身不支持注释К区分的功能;各种设计工具都可以利用“分版本注释法”新增相应功能;作〢者本人也在∮■研究实现中…

 

本文由 @有刀 原创发布于人人都是产品经理。未经许可,禁止转载

题图来自Unsplash,基于♀CC0协议

上一篇: 网易云音乐与B站,可能是唯二的两个意外
下一篇: 为什么Lisp语言如此先进?(译文)