我正在为一个涉及多个开发人员的项目编写文档。我们使用Subversion (SVN)来处理我们的代码库。
我使用HelpNDoc编写了文档文档的初稿,我喜欢它的树状视图和易用性;问题是只有一个文件,所以我不知道如何使用SVN来允许其他开发人员对文档进行贡献和更新。
你知道这是否可能吗?如果没有,你能建议一个好的软件,易于使用,具有文档的树形视图,可以与SVN一起使用,或者使多个用户可以更新它吗?我们使用Windows。
发布于 2016-09-21 16:47:17
HelpNDoc项目是基于SQLite开源数据库引擎的二进制文件。优点是整个文档存储在一个文件中,因此可以很容易地复制、移动、共享、备份……然而,一个缺点是它必须在任何版本控制系统中作为二进制内容签入,包括Subversion: diff和merge在这些文件上是不可能的。
一种可能的解决方案是使用HelpNDoc库中的外部文档:每个用户处理自己的文档(可以是Word文档,也可以是HTML网页...)并且创建主HelpNDoc项目以在生成时包括这些文档。请参阅以下分步指南中的“在生成时包含文件”:How to add an item to the library
发布于 2016-09-09 20:41:46
文件的数量无关紧要,真正的格式(文本/*或二进制)-重要的。如果SVN|任何VCS可以合并两个具有不同历史的HelpNDoc文件(只需手动尝试),您将会很高兴
发布于 2016-09-10 20:10:10
我曾经使用Helpinator编写软件文档,它非常接近HelpnDoc,但它的存储格式更适合版本控制。
https://stackoverflow.com/questions/39409676
复制相似问题