软件项目的文档

Question

我正在与一个非常大的软件项目的团队一起工作，我们有大量的文档是用MS WORD格式编写的，没有超链接索引，没有搜索能力。每天，我们都在浪费时间去寻找确切的文档或参考资料。

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

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

Answer 1

Confluence wiki允许您导入Word文档。有人告诉我，这是一个非常好的wiki，有很多功能。

Answer 2

开源: Trac Wiki

Trac Wiki系统是一种流行的开源选择。在另一个Stack Exchange网站上甚至有一个关于转换Word documents into the Track Wiki format的帖子。Trac的一些大规模或著名的用户包括红帽，Django，手刹车和SourceForge。

商业广告:融合

正如Alex Korban所提到的，Confluence是另一个流行的选择。大规模使用它的一个很好的例子是软件公司JBoss的Application Server 7社区文档。

2015年更新- PressGang和Corilla

我只需要添加一个快速更新，我非常同意这个可发现内容和协作的问题，我已经在几个不同的项目中解决了这个问题。

PressGang (原型)

请参考PressGang CCMS项目，了解我们在Red为构建工具来解决此问题所做的工作。首席工程师做了一个run-through video，你可以在Vimeo上看到，我已经创建了一个公开的Amazon AMI，如果你想试一下的话。它没有得到维护，但它都是开源的。查看存储库或参与the community fork。

Corilla (产品)

这是一次令人惊叹的经历，并激励我推出了Corilla，这是一个开源的技术写作初创公司，完全解决了你提到的问题。它既有商业/企业版，也有开源社区版。有一个目前正在运行的测试版，我将encourage you to get involved with -你所经历的问题将很好地塑造正在构建的解决方案。

Answer 3

我不知道如何将MS Word转换为Wiki，但如果您将文档保存为ODF (来自OpenDocument的XML格式)，则应该可以在您自己的程序中导入文档，或者使用XSL转换它们，然后将它们输出为Wiki格式。

在这个过程中，你可以尝试猜测一些基于字符串匹配的链接。

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