教你写前端项目设计文档

10,365 阅读2分钟

前言

每个人都是从一个小白成长起来的,成长的路上,遇到过很多问题,每解决一个问题,便是自己向前迈进的一步。

今天在这里分享一下前端项目设计文档都有什么内容。

项目文档的作用

前端项目文档的作用有这么几个,首先是方便后期维护、其次是方便新人接手、再者是项目可规范、...。一句话总结:好处大于坏处。

项目文档的内容

前端项目文档的内容大概有这些,项目的署名、项目的背景、项目的术语定义、项目的运行环境、项目的部署、项目的接口说明、项目的编码规范、项目的技术选型、项目的逻辑视图、项目的参考资料、...

项目的署名

项目的署名描述的是文档的编写者的信息。

项目的背景

项目的背景描述的内容是为了解决什么问题,启动了这个项目。

项目的术语定义

项目的术语定义描述的是为了统一采用一样的表达但又怕读者不理解而作的解释。

项目的部署

项目的部署描述的是项目采用相关的工具将代码部署到对应的环境,比如生产环境、uat环境、测试环境、开发环境。

项目的运行环境

项目的运行环境描述的是项目需要运行在什么版本的桌面浏览器、什么版本的移动浏览器、什么版本的什么应用(微信/支付宝)的小程序、...

项目的接口说明

项目的接口说明描述的是项目采用什么数据传输协议、什么传输数据格式、什么样的数据结构、...

项目的编码规范

项目的编码规范描述的是采用什么编码规范,这一块内容有很多参考的规范,著名的互联网公司基本都有自己的一些规范。

项目的技术选型

项目的技术选型描述的是项目采用什么技术,比如Vue、react、微信小程序、flutter、...,以及其他一些配套的插件、组件库、构建工具之类。

项目的逻辑视图

项目的逻辑视图描述的是项目的各个模块的逻辑实现,呈现的形式可以是逻辑流程图、也可以是文字、也可以是时序图。

项目的参考资料

项目的参考资料描述的是项目的相关文档资料,可列出文档资料超链接。

谢谢阅读!

需要加微信交流,可留言!