Documentation 软件项目的文档

Documentation 软件项目的文档,documentation,documentation-generation,Documentation,Documentation Generation,我和一个团队一起工作,这个团队致力于一个非常大的软件项目,我们有大量以MS WORD格式编写的文档,没有超链接索引,没有搜索能力。 每天我们都在浪费时间寻找准确的文件或参考资料 我在想,是否有一种方法,或者甚至是一种专业的工具,可以将所有这些转换成wiki格式,或许在一点手动(痛苦)帮助下,可以组织成一些可以提高可访问性的东西。 我使用谷歌桌面搜索让我的生活变得更轻松,但这不是最好的解决方案 我只想知道你们中是否有人遇到过类似的问题和可能的解决方案。不知道将MS Word转换为Wiki的工具,但

我和一个团队一起工作,这个团队致力于一个非常大的软件项目,我们有大量以MS WORD格式编写的文档,没有超链接索引,没有搜索能力。 每天我们都在浪费时间寻找准确的文件或参考资料

我在想,是否有一种方法,或者甚至是一种专业的工具,可以将所有这些转换成wiki格式,或许在一点手动(痛苦)帮助下,可以组织成一些可以提高可访问性的东西。 我使用谷歌桌面搜索让我的生活变得更轻松,但这不是最好的解决方案


我只想知道你们中是否有人遇到过类似的问题和可能的解决方案。

不知道将MS Word转换为Wiki的工具,但如果您将文档保存在ODF(OpenDocument的XML格式)中,则应该可以在您自己的程序中导入文档,或使用XSL转换它们,并以Wiki格式输出它们

在此过程中,您可以尝试根据字符串匹配猜测一些链接

在一个用文字处理器编写文档(甚至不使用文字处理基本功能,如索引、目录和超链接)的团队中,最困难的部分是说服他们使用另一个不是打字机的系统。

允许您导入word文档。有人告诉我这是一个非常好的wiki,有很多特性。

开源:Trac wiki 该系统是一个流行的开源选项。在另一个Stack Exchange站点上甚至有一个关于转换的线程。Trac的一些大型或著名用户包括Red Hat、Django、Handbrake和SourceForge

商业:合流 正如Alex Korban所提到的,这是另一个受欢迎的选择。软件公司JBoss的社区文档是大规模使用it的一个很好的例子

2015年更新-PressGang和Corilla 我只想添加一个快速更新,我非常同意这个发现内容和协作的问题,我已经在几个不同的项目中解决了这个问题

PressGang(原型) 请参考该项目,了解我们在Red Hat所做的工作,以构建解决此问题的工具。首席工程师做了一个你可以在Vimeo上看到的测试,如果你想尝试的话,我已经创建了一个公共的AmazonAMI。它没有被维护,但它都是开源的。查看存储库或参与其中

科里拉(产品)
这是一次令人惊异的经历,并激励我加入spin out,这是一家开源技术写作初创公司,正是为了解决您提到的问题。这将提供商业/企业版以及开源社区版。目前有一个测试版正在运行,我想-你正在经历的问题将是伟大的塑造正在建设的解决方案

这个问题定义了汇流的最常见用法。它非常适合以易于发现、编辑和导出(PDF、Word.doc、HTML)的格式存储文档。