documentation - 什么是收集业务规则文档的好解决方案？

Question

关闭。这个问题不符合Stack Overflow guidelines .它目前不接受答案。












想改进这个问题？将问题更新为 on-topic对于堆栈溢出。

4年前关闭。




Improve this question




我遇到了一种情况，我敢肯定，我的业务规则文档分布在电子邮件、文档(现已过期)和即时消息中。这很臭。

我可以想到 2 个替代方案:Sharepoint(讨厌它，搜索功能很糟糕)或 wiki。

我希望在理想解决方案中看到的一些东西:

易于更新 : 不要让我打开 Word 来更新文档

差异 View : 有时候你只需要看看有什么新鲜事

订阅 :逐页通知新更改

基于角色 : 页面的编辑和查看可以绑定(bind)到角色

附件 : 轻松包含模型、文件等。

搜索 : 这是一个post google world，我希望能够立即搜索和找到--Sharepoint 在这个类别中输了，除非我们使用的那个配置不正确

附件限制 :理想情况下，该解决方案不允许上传一堆我们称为文档的 Word 文档。我希望文档具有一致(且简单)的格式。强制附件为 PDF、txt 等。

跟进我的 wiki 评论，似乎有 at least 3 wikis做我想做的事(激励、SharePoint-Wiki-Plus、ThoughtFarmer)。 ThoughtFarmer，喜欢这个名字。

Answer 1

+10⁶ 用于 Wiki，这是迄今为止我找到的最好的文档解决方案，尤其是技术文档。 IMO，“好的” Wiki 引擎优于 VCS 中的 Office 文档的优点是(但您已经意识到这一点，因为此功能列表非常接近您的要求):

它们只是比 VCS 中的 Office 文档更快、更容易使用(无需打开 VCS 客户端、 checkout 最新版本、可选择锁定、打开 word、保存、 checkin 、释放锁定)

它们是基于文本的，因此您可以制作差异(与 word 不同)，这只是必须的

他们提供通知机制(例如邮件、RSS)，因此信息会推送给您(与 VCS 不同，您需要在文档过期时提取文档)

没有“文档被另一个用户锁定问题”，因为有人忘记释放它(如果您使用排他锁，这通常是您无法合并的文档的情况)

页面可以轻松重构、重组、组装成更大的文档

他们真的很合作

它们为代码提供了更好的支持(例如，您可以直接指向 VCS 中的源代码，其格式比 word 中的要好得多)

他们可以索引页面和附加文档(pdf、office docs等)的内容并使其可搜索

在使用 Wiki 获取文档时，我遇到的唯一问题是，很难在编写代码的同时对文档进行版本化(即，您交付版本 x.y.z 并希望“锁定”该版本的文档)。我已经使用导出来解决这个问题，但它并不完美。

我已经使用过 TWiki Foswiki , Confluence和 XWiki .它们都是“好”的 Wiki 引擎(如上定义)并且都满足您的要求。因此，最终选择可能仅取决于您的限制条件(许可、定价、技术)和个人偏好。

到今天为止，如果可以选择商业工具，我会选择 Confluence，如果不是，我会选择 XWiki。