如何编写前端设计文档.docVIP

如何编写前端设计文档? 在笔者所在的前端研发流程中, 【技术调研及方案设计】属于连接【需求阶段】和【开发阶段】的中间节点。在需求详评(三审)后了, 需求的功能和交互已经基本确定, 而在实际进入开发之前, 还有一些 待确定的技术要点需要补全, 这些要点包括: 需求的可实现性 (理论上能不能做, 是否能支持某个功能, 某个交互是否能实现, 实现功能的成本是否过于巨大),假设你给PM拍胸口说啥功能你都能实现, 然后Ta提了一个这样的需求[1]... 需求的整体架构(前后端交互的流程和方式, 接口的路径、请求和响应参数) 需求的具体设计(前端页面/组件/服务的设计) 而编写前端设计文档就是补全和完善上述这些技术要点的过程以及过程沉淀出的产物. 为什么写前端设计文档? Measure twice?and?cut once?三思而后行 如果所有产品的功能都是在页面上展示Hello, World的话, 那么我们大概是不需要设计文档的，然而现实世界的产品需求功能充满了复杂性, 一个页面可能展示了非常多不同来源数据, 有不同的交互细节, 周密的业务流程, 这就要求我们需要在动手开发之前先想好这个功能能不能实现以及如何实现. 试想一下如果不写设计文档, 撸起袖子就开干可能会有哪些Bad Ending? Case 1: 需求要你接入一个第三方SDK, 你和第三方的研发同学开了个小会对齐发现没有啥问题,