作者:UOrb

声明:文章为稀土技能社区首发签约文章,14天内制止转载,14天后未获授权制止转载,侵权必究!

前语

尽管许多描述看起来比较 “主观” 哈,可是这是为了投合 文章 方式,正常来说需求文档要以 “客观真实” 的方式来进行书写才是。

项目背景

勉强算是爱好使然吧,之前做 wangEditor 的时分,略微对 富文本修正器 有少许了解,也从前规划过相似平台的计划,仅仅终究没有实施出来。

然后 wangEditor 做第五版别的重构的时分,由于作业上的原因导致脱节了,也就没有继续参加的开发了。

接着又由于一些原因,现在的事务时刻上相对来说比较宽余,可是 wangEditor 第五版别现已做的差不多了,也就没有必要再参加进去了,所以就想着有没有其他的东西能够做,就想到了之前规划的 平台 和之前比较感爱好的 协同算法,终究就有了想做一个 在线文档 的主意。

签约作者计划的签约作者需求针对某个方向(专栏)写一系列的文章,正好能够和上述的主意交融在一起,所以就有了 手把手从零到一打造在线文档 专栏了。

项目价值

一般来说,大部分在公司的作业都和 事务场景 脱离不了关系,而然正常来说仅仅仅仅做事务是容易抵达瓶颈的,出去找作业也很难有多高的 竞争力,所以需求有一个别的的途径让自己更 专心 于技能或许某个领域,在进步自己的技能能力之外,一起在找相对应的作业时也更有 竞争力

由自己来从零到一来界说一个项目需求阅历 需求搜集 - 需求调研 -> 需求分析 -> 需求评审 -> 技能调研 -> 技能计划设计 -> 前端开发 -> 后端开发 -> 项目部署 -> 运维 -> 迭代 等进程,一般来说依据各自 岗位和职责 的不同会分属到整个流程中的某个部分,很少会有人能 贯穿始末,可是这儿就需求自己一个人负责和处理一切阶段的内容,从一而终 贯穿始末,这能够让自己愈加了解到一个项目 完好 的生命周期,能够对自己作业中的 定位 愈加清晰。

一起也能够收获一个符合自己习气和预期(依据自己的习气、需求和主意来完结在线文档,不用一定文章一毛一样的)的在线文档,甚至能够引入到公司中,作为公司内部专属的在线文档和知识库,给自己的晋升和年终奖打下基础(狗头保命)。

竞品调研

正儿八经的竞品调研阶段的案牍,会很严谨,而且会有具体的阐明以及对比后的优缺点。

一般来说想要确认一个 清晰的需求 是需求做相对应的 需求调研 的,我本人也 没有 正儿八经的体系学过也 没有 该方面的具体经历,所以这儿仅仅趋于我使用过的在线文档,例如:语雀、腾讯文档、飞书文档 等,再结合本身的 体验 来决定我自己要做的 在线文档 具有哪些功用以及方式。

调研之语雀

我个人用的最多的在线文档应该便是 语雀 了,首要我最喜爱的或许便是 知识库 的面板功用了,尽管转换过来便是 文件夹 + 文件列表展现 的能力,可是能够很好的对文件进行分类和办理,比直接的文件夹看起来会更清晰,至少关于我来说 语雀 的 知识库 给我的体感很好。

可是语雀 空间 + 团队 + 知识库 + 更新 的链路着实有些长,操作起来着实有些繁琐,特别是 更新 的操作那是又爱又恨,爱是由于修正后的文档不是实时更新的,能够调整好后再进行更新,恨是由于常常修正完结后忘掉点更新按钮进行更新。

调研之飞书文档和腾讯文档

飞书文档和腾讯文档的方式 根本相似,市面上大部分的 在线文档 也都是这种方式,相似于 Office、WPS 等工作软件。

个人 其实是不太喜爱或许习惯这种方式,由于在 电脑 上一般是经过电脑的 文件资源办理器 来对文件进行 分门别类办理 的,事实上关于大部分人来说想要修正某个文档第一步是经过 文件资源办理 来找到该文档文件,而不是经过翻开 客户端客户端记载 里面查找。

可是这类文档的 链路 相对来说就比较短了,一般来说都是同首页的最近或许查找 查找 某一个文件,当然它们也能创立文件夹什么的,可是 UI 视图都是列表,而且无法创立单独的空间出来,所以不那么 直观,相对来说操作也会更 便捷和简练 一些。

调研定论

总的来说各大在线文档都有自己的 优势和劣势,它们的 倾向 各不相同,所以也没有什么高低之分,用户只需求依据本身的具体状况和 需求 来挑选最符合自己预期的就好。

那么关于我来说,首要我需求能创立 独立的空间 而且需求更好的文档 分类和办理(强迫症?) 的能力,所以我计划参考语雀的 空间 + 团队 + 知识库 的方式,可是语雀的 空间 关于我来说许多余,而且会拉长全体的途径让操作的 过于繁琐,而且语雀的团队现已能 满足 我的创立独立空间的需求,所以略微调整一下,我只需求 独立空间 + 知识库 的途径。

别的关于保存是 手动更新 仍是 主动更新 这件事儿吧,我仍是比较拿捏不准的,主动保存十分方便,可是有时分没写完或许试验性的写作就不太想让它直接展现出去,手动保存的可控性十分的强,能够自己操控是否要把当时更新进行展现,尽管能够考虑一下给每个文档增加一个装备,是否主动保存的选项,勾选了则会主动保存,不然需求手动保存,但实际上也是延长了整个操作链路有点多此一举的感觉,由于初期是 个人项目 没有太多的展现担负,所以先决定使用 主动更新 的计划。

功用需求

在线文档的 中心难点 在于 富文本修正、协同算法 等方面内容,其他也仅仅正常的事务范围,富文本修正其实能够在 Github 上找到许多优秀的开源项目,协同算法 这个不是初期考虑的工作,是后期迭代中重要的功用。

功用结构

手把手从零到一打造在线文档之书写需求文档

登陆和注册

登陆和注册就没啥可说的了,根本都那样,原型图这咱这也 设计 不出啥美观的 UI 不是。

登陆和注册成功后主动跳转至 个人中心 页面

用户名最短六位数,最长不能超过二十六位数,必须由字母开头,不能含特别字符;
暗码最短六位数,最长不能超过二十六位数,不能含特别字符。

手把手从零到一打造在线文档之书写需求文档

个人中心

个人中心归于在线文档的 主要页面 了,大部分状况下使用在线文档 第一步 都是会进入到个人中心页面,然后经过个人中心页面再来 流转到 其他的功用页面或许文档之中,所以个人中心直接就对标着 用户体验度 的好坏了。

知识库面板

一个空间下面能够创立若干个知识库,一个知识库下面能够创立若干文档,文档必定有一个所属的知识库,知识库必定有一个所属的空间。

经过个人中心上方的 header 中的 操作栏目 中的 新增空间 按钮,能够唤出新增空间弹框,新增空间弹框中需求填写 空间称号简介 两项数据,当然也能够依据 需求 来设置更多的项进行填写和装备。

修正空间则经过 面板 中的 标签页 切换到设置中进行更新。

创立空间需求填写空间称号和空间简介,其间空间称号是必填且不能有特别字符。

新增知识库则需求在知识库面板的 功用按钮 中点击新增按钮,引发新增知识库弹窗,弹窗中需求填写知识库的 称号简介,而且需求挑选新增到的空间,默认挑选当时空间

已有知识库的信息变更则能够在对应知识库卡片上的 操作下拉菜单 中引发修正弹框,也能够在知识库概况中引发修正弹框。

创立知识库需求填写知识库称号、知识库简介以及所属空间,其间知识库称号和所属空间是必填且不能有特别字符。

一起知识库面板能够经过操作下拉菜单对自己进行重命名、删去等操作。

手把手从零到一打造在线文档之书写需求文档
手把手从零到一打造在线文档之书写需求文档
手把手从零到一打造在线文档之书写需求文档
手把手从零到一打造在线文档之书写需求文档

知识库目录

点击知识库面板的知识库称号,就会进入到知识库目录,会经过列表的方式展现该目录下的一切文档,而且能够经过操作下拉菜单对文档进行翻开、删去、装备变更等操作;一起也能够在目录中创立新的文档。

手把手从零到一打造在线文档之书写需求文档
手把手从零到一打造在线文档之书写需求文档
手把手从零到一打造在线文档之书写需求文档

最近阅览

阅览记载能够帮助使用者快速的 回顾 最近阅览的文档,能够在某种程度上快速找到 目标文档 ,减少操作途径,阅览记载也是以 文档列表 的方式展现,经过 拜访时刻 进行倒序排列。

阅览记载的 文档列表知识库文档列表 的方式相近,可是无法对文档进行修正装备、删去等操作,只能翻开该文档,阅览记载中也无法创立新的文档。

阅览记载中能够经过查找功用快速查询指定文档。

手把手从零到一打造在线文档之书写需求文档

回收站

回收站是用户近期删去的文档集合,也是以 文档列表 的方式展现,回收站内的文档无法进行查看、更新、修正装备等操作,只能对其进行操作栏目的 康复、直接删去 的操作,康复会将该文档的删去取消,文档将会回到原始的知识库中,直接删去则是将文档彻底的删去了,再也找不回来了。

回收站中能够经过查找功用快速查询指定文档。

手把手从零到一打造在线文档之书写需求文档

结尾

其实本文的需求阐明,仍是十分的 粗糙,正常来说 需求文档 会在功用阐明的时分顺便上原型上展现内容的 字段阐明 、操作阐明、字段阐明、数据来源、状况判定关系 等等。

然后这究竟归于 个人项目 ,一切的一切 “自己” 进行把控,所以 需求 相对来说粗糙了许多,由于许多东西 “自己” 能够 挑选性 的把控,可是在公司的项目傍边,由于是 多人、跨团队 的协作开发,所以需求 越具体、越清晰 就越好,一起在你阅览或许书写技能计划设计的时分,发现需求有不清楚或许不合理的时分,就要 及时 的去反馈和咨询,尽早和尽或许的把 前端、后端、产品 三方对需求的理解 对齐,不然放任不管到最后或许会导致各种各样的 问题,例如:反复横跳、计划重做、项目延期 等状况。

一个好的需求文档,能让项目开发少走许多 弯路,能让 前端、后端、设计 在内的一切项目参加人员对自己要做的需求有一个 清晰的画像,能更快更好的完结需求内容。

最后总结一句:无他,唯胸中有数尔。