产品文档的规范

好的产品文档应该是怎么样的呢?

首先明确为什么要撰写产品文档:

  1. 产品文档的终极目标是统一产品、开发和设计的共识,建立对项目的共同理解,并指导产品、开发和设计进行具体的工作。所以在书写的时候,要对阅读对象的理解能力和知识水平以及对这个项目的了解程度都要有个大致的判断,确保每个人都可以看得懂;
  2. 产品文档和产品一样,本身也是一个不断更新的过程。每个阶段需要的产品文档是不一样的,所以一定要有很好的版本控制;

好的产品文档应该包含以下十个部分:

  1. 产品概述;

    讲我们为什么要做这样一个产品,以及我们要将这个产品做成什么样子;

  2. 产品解决的痛点;

    这个产品解决了什么问题,我们的机会在于哪里;

  3. 产品的目标和范围;

    定义什么是产品的成功,是最终的用户量,还是收入;
    范围是定义产品的边界,主要是做什么和不做什么,其中最重要的是之后一定不会做什么;

  4. 核心的KPI

    产品有了目标,那一定要有可以衡量目标的KPI,指标性的东西来帮我们判断自己的努力是否有了预期的回报;

  5. 产品需求

    产品需求指的是一小列通过用户的视角撰写的声明。例如“我希望通过这个产品我可以实现”,它不需要包含具体的实施细节,也不需要写具体的界面元素。它们只是对于产品成功的一些具体表现;

  6. 产品的设计原则

    主要是一些框架性的原则,作为之后判断需求的标准。比如facebook的设计原则就是:universal, clean, consistent, useful等等;

  7. 用户故事

    用户故事的三大元素:谁,是什么,为什么。这是一个比较直接的表述。一般在设计师眼里,会考虑更多的场景,动机,用户行为以及最终的价值实现。所以一般一个产品,会支持若干个优先级的用户故事。每个用户故事是描述了一段独立的end-to-end的使用体验。它包括:用户画像(persona),使用场景(context), 使用意图(intent), 步骤(flow), 产品价值(value, 产品如何帮助用户实现价值),以及优先级(priority) ;

  8. 设计原则

    产品经理可以提供给设计师的一些参考意见;

  9. 依赖关系

    每一个产品模块之间是什么关系,先交付哪个,后交付哪个;

  10. 测试计划

    完整的测试计划,确保产品质量没有任何问题;