当前位置:网站首页>远程办公之大家一同实现合作编辑资料和开发文档 | 社区征文
远程办公之大家一同实现合作编辑资料和开发文档 | 社区征文
2022-07-03 16:05:00 【InfoQ】
问题
- 我们相关的一些开发设计文档,该如何实现协同编辑?采用哪种方式进行编辑?如何进行合并以及实时通知大家去修改,完成相关的文档?
- 相关的API设计文档资料:一般而言会分为面向对外的OPEN-API文档,对内的内部开发人员的设计接口定义文档。如何实现有效和合理的文档编写,并且大家都可以同时进行编辑调整?
- 相关的需求文档的控制,不能每一个人到处转发,编辑的修改痕迹,也无法达成统一,并且有些标注,业务无法直接书写留痕,此外针对于人员的通知能力也很难做到,向所有人进行通知。
解答
- 首先,如何实现相关的开发设计文档的协同编辑?那方法就很多了,比如向我们目前公司常用的coding、wiki以及lark自带的编辑文档。
- coding,主要采用的就是比较面向于开发人员角度了,更多的时候,我们会采用它去书写一些设计文档,包含架构图以及内部开发相关的接口设计文档,流程图等等操作控制。
- jira,相信大家并不陌生了,就是针对于一些大家内部开发人员之间针对于系统功能相关的设计文档,也算是一个coding编写相关文档的内部化文档了,还有就是一些相关的信息登记,也我们会采用jira方式编写原因之一。
- lark自带的编辑工具,我们采用的是lark的通讯工具,其实就是我们常说的飞书,它其实是支持相关的在线文档,很类似钉钉的功能,通过lark推送到跨部门群,多部门可对异常数据进行标注,再划分人员对问题进行跟进解决,实现数据化在线协同办公。
- 针对于外部的OPEN-API文档采用的是,vuejs编写的相关的api页面进行展示,也就是相关的开发页面,虽然需要一定的开发成本,但是因为是全局唯一化的,我们采用的git去维护,所以就可以实现相关的协作处理和大家公共开发调整。而另外一方面,我们采用的是jira或者是coding去开发设计,真的样子就可以内部化分享了,代替传统的word文档,简直是方便又便捷。
- 第三点,其实是采用lark去处理的,因为lark自带的文档,是支持企业内部的相关的人员的选择,这样子就不用再进行通知对应的人员,它提供了相关@选择人员之后,直接进行发送通知信息,此外文档还可以添加相关的批注,真的是非常方便啊!
边栏推荐
- About text selection in web pages and counting the length of selected text
- [proteus simulation] 74hc595+74ls154 drive display 16x16 dot matrix
- Secsha system 1- login function
- Distributed task scheduling XXL job
- "Everyday Mathematics" serial 56: February 25
- The difference between RAR and zip files
- Get the executable path through the process PID (queryfullprocessimagename)
- App移动端测试【5】文件的写入、读取
- [system safety] 43 PowerShell malicious code detection series (5) automatic extraction of ten thousand words from abstract syntax tree
- Intelij idea efficient skills (III)
猜你喜欢
Semi supervised learning
Microservice API gateway
Redis installation under windows and Linux systems
How to thicken the brush in the graphical interface
[system safety] 43 PowerShell malicious code detection series (5) automatic extraction of ten thousand words from abstract syntax tree
嵌入式开发:避免开源软件的7个理由
“用Android复刻Apple产品UI”(2)——丝滑的AppStore卡片转场动画
MB10M-ASEMI整流桥MB10M
Uploads labs range (with source code analysis) (under update)
About text selection in web pages and counting the length of selected text
随机推荐
Batch files: list all files in a directory with relative paths - batch files: list all files in a directory with relative paths
Unity功能——Unity离线文档下载及使用
App移动端测试【3】ADB命令
pyinstaller不是内部或外部命令,也不是可运行的程序 或批处理文件
Function introduction of JMeter thread group
First!! Is lancet hungry? Official documents
工资3000,靠“视频剪辑”月入40000:会赚钱的人,从不靠拼命!
利用MySQL中的乐观锁和悲观锁实现分布式锁
Microservice - Nacos registration center and configuration center
Detailed pointer advanced 1
MongoDB 的安装和基本操作
阿飞的期望
高等数学(第七版)同济大学 习题2-1 个人解答
首发!!lancet饿了么官方文档
Project -- high concurrency memory pool
“用Android复刻Apple产品UI”(3)—优雅的数据统计图表
Srs4.0+obs studio+vlc3 (environment construction and basic use demonstration)
App移动端测试【4】apk的操纵
[combinatorics] combinatorial identities (review of eight combinatorial identities | product of combinatorial identities 1 | proof | use scenario | general method for finding combinatorial numbers)
CString getbuffer and releasebuffer instructions