什么是收集业务规则文档的好方法?

jco*_*lum 18 documentation wiki business-logic

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

我可以想到两个选择:Sharepoint(讨厌它,搜索功能很糟糕)或维基.

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

  • 轻松更新:不要让我拉起Word来更新文档
  • 差异视图:有时您只需要查看新内容
  • 可订阅:逐页通知新更改
  • 基于角色:编辑和查看页面可以与角色相关联
  • 附件:轻松包含模型,文件等.
  • 搜索:这是一个谷歌后世界,我希望能够立即搜索和查找 - 除非我们使用的那个配置不正确,否则此类别中的Sharepoint会丢失
  • 附件限制:理想情况下,解决方案不允许上传我们随后称之为文档的一堆Word文档.我希望文档具有一致(简单)的格式.以PDF,txt等方式强制执行附件.

跟进我的wiki评论,看起来至少有3个wiki可以做我想要的(Incentive,SharePoint-Wiki-Plus,ThoughtFarmer).ThoughtFarmer,爱这个名字.

Pas*_*ent 8

对于Wiki来说,它是+10⁶,这是迄今为止我发现的文档,特别是技术文档的最佳解决方案.IMO,VCS中"好"Wiki引擎优于Office文档的优点是(但您已经意识到这一点,因为此功能列表非常接近您的要求):

  • 它们比VCS中的Office文档更快更容易使用(无需打开VCS客户端,签出最新版本,可选择锁定它,打开单词,保存,签入,释放锁)
  • 它们是基于文本的,所以你制作差异(不像单词),这只是一个必须具备的
  • 它们提供通知机制(例如邮件,RSS),因此信息被推送给您(与VCS不同,您需要在文档过期时提取文档)
  • 没有"文档被另一个用户问题锁定",因为有人忘了释放它(如果你使用的是独占锁,通常情况就是你无法合并的文件)
  • 页面可以轻松地重构,重新组织,组装在更大的文档中
  • 他们真的很合作
  • 它们为代码提供了更好的支持(例如,您可以直接指向VCS中的源代码,其格式比单词更好)
  • 他们可以索引页面和附加文档(pdf,office docs等)的内容并使其可搜索

我在使用维基文档时遇到的唯一问题是,在您的代码的同时对文档进行版本更难(即您提供版本xyz并希望"锁定"此版本的文档).我用出口来解决这个问题,但这并不完美.

我已经和TWiki Foswiki,ConfluenceXWiki合作了.它们都是"好的"Wiki引擎(如上所定义)并且都符合您的要求.因此,最终的选择可能仅取决于您的约束(许可,定价,技术)和个人偏好.

截至今天,如果商业工具是一个选项,我会选择Confluence,如果不是,则选择XWiki.