V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
yancy0l
V2EX  ›  问与答

关于软件项目开发过程中的文档管理问题

  •  
  •   yancy0l · 2023-06-12 10:28:00 +08:00 · 1026 次点击
    这是一个创建于 530 天前的主题,其中的信息可能已经有所发展或是发生改变。

    现在存在的问题,我们是自有产品,会针对当前的版本由不同的人同时开发多个需求,期间可能会修改项目文档,用户手册,接口文档(接口文档根据不同的业务有 10 个左右)等,目前的项目文档是 word 版本。

    在对应的版本发布之后,会将不同的版本合并到一个分支上,合并代码是比较简单的,但合并 word 文档,不太好处理,git 不能很好的对比两个 word 文档的插件,项目开发者可能在项目开发过程中对文档持续性做修改(比如某个必填项名称,说明,设置某个错别字),让开发者记录每个修改细节不太好实现。

    所以,想问问大家有没有这种并行开发,并最终需要合并文档的情况,或者项目开发过程中的文档修改是怎么维护的,我个人目前用对比工具可以大概看到差异,但是对比工具不是专业的,对比效果不太好

    第 1 条附言  ·  2023-06-12 18:03:40 +08:00
    大家的建议,看到了,之前就听过飞书文档,主要是我们公司,重视软件版权,所以一直没试过,接下来去研究下。
    5 条回复    2023-06-12 17:21:39 +08:00
    onetown
        1
    onetown  
       2023-06-12 10:37:58 +08:00
    现在大多数开源项目使用 markdown 或者 rst 来写文档, 这个也更适用于 dev , 文档也可以有自己的 pipeline , 来生成 pdf , 或者转成 docx 之类的格式, 不过如果能维护一套在线的文档的话,pdf, docx 是不是也没必要了.
    LeegoYih
        2
    LeegoYih  
       2023-06-12 10:55:10 +08:00
    用云文档,语雀、金山、石墨这种,自带历史版本
    vtexer
        3
    vtexer  
       2023-06-12 11:43:54 +08:00
    飞书云文档吧,项目管理也能搞定
    adoal
        4
    adoal  
       2023-06-12 11:48:16 +08:00
    如果一定要重度使用 Word ,唯有 sharepoint 是正途
    huzhizhao
        5
    huzhizhao  
       2023-06-12 17:21:39 +08:00
    云文档吧 自带版本管理
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2710 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 12:02 · PVG 20:02 · LAX 04:02 · JFK 07:02
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.