A1 产品文档那些事儿(上)-文档结构与团队协作

我们先来搞清产品文档的主要目的和问题:

基于以上问题和原因,我们从以下三方面来解决:

一、撰写规范:写什么怎么写

二、团队协作:用什么工具写

三、实际应用:迭代中如何用

一、撰写规范:写什么怎么写

【产品文档结构】

其中,最重要的2个部分:

1、产品总览

涉及到的业务流程图、功能结构图等几个大图是做新产品很关键的部分,改天逐个展开介绍

2、原型注释

是每个执行人员看的重点,只要按照结构化的框架做好梳理和表达就可以

【原型注释示意图】

最后,给一个类似的在线文档参考模板:

https://xiaopiu.com/prd/5e9fbe89eae5147c68aa9cd4

这样,我们就可以一个人输出一篇优秀的产品文档

二、团队协作:用什么工具写

当进行团队协作时,只是文档写的好还不够,还需要使用工具提高协作效率

祭出王炸工具组合:Axure团队项目 + 飞书在线文档

1、 使用Axure-团队项目,产品经理可同时维护一个文档

方法如下:

1.1 在Axure创建团队项目

先创建/打开一个Axure文件,然后如下图操作,右图两个红框的地址拼接起来就是该文件在SVN的位置(之所以使用SVN,是因为Axure share的速度慢到令人发指)

1.2 定好规范

按照上面一步搭建文档结构,做好分工,并给出组件规范,利用好模板功能,保证文档的一致性

1.3 协作者打开Axure,获取团队项目

输入SVN地址:svn://svn.myrrx.com/axure/今借到(即上一步创建的产品的地址+名称)

找到一个空白文件夹存放

验证SVN账号的用户名和密码

1.4 产品经理同步编辑文档

对于要更新的页面右击-check out,更新完check in,别的PM才能改,只更新不退出编辑选send change,以上操作都可在Team里面批操作,一定要及时check in,避免协作冲突

1.5 研发协作查看

下载蓝湖/摹客插件,Axure点击预览后,可一键更新文档

将链接分享给同事,查看方便且更新及时

蓝湖收费,但目前来看比摹客更稳定

2、 使用飞书在线文档编辑辅助的文档资料,全部资料都在线存储,后续维护变简单

飞书对文档格式支持的非常全,包括流程图、思维导图,体验也很棒,还免费

相比其它工具:腾讯文档、 teambition、process on更便宜更好用

这样,内部团队就可以通过2个链接高效地对文档进行管理协作

不怕丢失、不怕离职、快速同步更新、一直拥有全面且最新的文档

三、实际应用:迭代中如何用

产品文档最终落地到需求迭代中,执行过程中为了省事很容易把文档维护的面目全非,一定要把握住2点:

1、产品文档要始终按照功能模块整体维护,如果不是新功能只是优化已有功能,切不可用需求的角度新增页面,要在原有页面上全局修改,并定期更新版本记录

2、为了开发人员快速了解到改动点,需要配合一个需求文档,说清需求的背景目的、列清改动点、对应的文档地址,需求文档可以在团队现有的项目管理平台上在线编辑,这类软件就有很多了,只看编辑需求文档这一个目的的话,都能满足,整体比较个人推荐teambition

【需求文档模板】

这样,通过1个整体产品文档+N个需求迭代文档,就可以很好地完成需求迭代啦

以上这套产品文档方案,是我基于真实遇到的问题,经过数年研究实践调整得到的,亲测好用~

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容