logo标签列表

软件/平台共享规格

documentationspecificationscollaboration
7
你用什么软件或维基来编写和分享有关开发人员、测试人员和管理人员的规范？
你是否使用维基系统，如果是，你使用哪个维基软件？
或者你使用Sharepoint来管理和版本规范？SharePoint 2003作为规范平台的一个问题是很难在不同的人之间进行协作。
出于向后兼容性的考虑，我也希望该平台能够无缝地导入Microsoft Word。如果界面类似于Microsoft Word，那肯定会有所帮助。
有任何想法吗？
12个回答
4
我在许多地方都使用了Confluence，它是一个非常强大的Wiki，非常适合创建可以在各方之间共享的规范。详情请见：http://www.atlassian.com/software/confluence/ 这里有更多关于使用Confluence的优点的信息：https://stackoverflow.com/questions/170352/confluence-experiences 编辑：我已更新此内容以处理您提到的Microsoft Word导入功能。 Confluence通过此处的Office Connector支持此功能：http://www.atlassian.com/software/confluence/plugins/office-connector.jsp 还有一个Sharepoint连接器：http://www.atlassian.com/software/confluence/plugins/sharepoint-connector.jsp，再加上一堆插件：http://www.atlassian.com/software/confluence/plugins/sharepoint-connector.jsp，其中一些是用户投稿的。我无法推荐Confluence作为商业Wiki。我还使用过JSPWiki，它是开源的。它还可以，但不如Confluence好，请参见：http://www.jspwiki.org/
3
你可以尝试使用 Google文档 - 我之前成功地使用过。它支持导入/导出到微软Word，并且对多个用户有很好的支持 - 详见http://www.brighthub.com/internet/google/articles/8236.aspx。它支持版本控制，允许您与其他正在编辑该文档的人聊天，并显示其他人对文档所做更改的列表（无需关闭/重新打开文档）。
如果你需要企业支持，Google也提供了Google应用商店。
2
我们使用SharePoint -- 它不是理想的，但它做得相当不错。如果我是你，我会认真考虑从SharePoint 2003迁移到MOSS（SharePoint 2007）。它不是完美的，但要好得多。这里有一些关于使用 MOSS作为Wiki的介绍。我认为通常来说，Wiki是让人们快速了解你的系统的好工具。我们曾经传递“入门文档”，现在我们把所有这些类型的东西放在我们的开发者门户网站上。
根据约翰的评论，我查看了此功能比较。我必须回去查看我正在使用哪些WSS中没有的功能--我可能正在支付我不需要的许可证费用！:)
@JP: 你认为WSS 3.0（SharePoint的“免费”版本）在这种协作方面与MOSS 2007几乎一样好吗？ - John Saunders
对于纯文档协作，可以。但是如果你需要像维基、博客、门户网站、出席管理（通信服务器）这样的功能，你需要完整的 MOSS。 - JP Alioto
我在TFS附带的WSS 3.0中使用了博客和维基。 - John Saunders
你说得完全正确。我不知道这些功能是WSS的一部分，而不是MOSS。 - JP Alioto
1

我们使用电子邮件。我知道这并不复杂，但它很容易使用。每个人都已经安装了它，也没有许可问题。所有规格更改都会发送到一个超级集电子邮件分发列表，指示更新和规格所在网络共享位置。

1
等到你需要多人编辑相同的文档，当你需要搜索页面时，才会知道使用电子邮件的痛苦。 - Graviton
1
@akf：积分旨在反映有用性，而非诚实度。 - mark4o
抱歉，这听起来像是一项调查。 - akf
1

我们使用Alfresco的社区版本，从其Share和Explorer Web界面中使用。 它非常有用，具有文档库、维基、论坛和日历等功能。 我们目前托管了约1.8 GB的内容，主要是文档，版本控制，并且有时会通过创建自动内容规则自动转换为PDF格式。 FTP、WebDav和网络共享也用于访问同一存储库。

1
你可以看看微软收购了几年前的协作软件Microsoft Groove。
它免费捆绑在Microsoft Office的高级版本中。
你可以使用讨论版来自定义工作区，并且可以相对无缝地存储协作编辑的Office文档。
1

我们使用MediaWiki来处理文档和规范。相比于Microsoft Word或SharePoint，Wiki绝对是更好的选择——它允许你以“先引用，再描述”、“分而治之”的方式来开发文档。这对于开发人员来说非常完美——他们也是这样思考的。文档开发的过程几乎是理想的：你从目录开始，一步步深入，直到为每个链接编写文档。

MediaWiki是相当可定制的——有很多扩展可以使用。最必要的扩展包括：

  • 源代码高亮器——CSO_Source
  • 我们自己的模板，将wiki与类参考集成在一起。
  • 其他扩展包括InterWiki、FileProtocolLinks、YouTube（我们使用定制版本来显示高清视频）、ReCaptcha、SpecialDeleteOldRevisions、Maintenance。

一些集成示例可以在这里找到。

我们使用Google问题跟踪器来跟踪问题。它的主要优点：

  • 输入的易用性：在那里添加/更改问题的过程非常方便。之前我们尝试过Track Studio - 相同的操作需要2-3倍的时间，所以它很快就死了，因为我们中的大多数人都不喜欢使用它。
  • 可自定义的网格。请参见示例。真的很有帮助。
  • Atom\RSS支持。这样每个人都知道发生了什么。
  • 有一个Gurtle工具将其与TortoiseSVN集成。真的很有帮助。

它的主要缺点是无法从公共访问中关闭。这使得它在许多情况下根本无法使用。

1
如果您想要一个类似于Word的用户界面，为什么不使用带有SharePoint 2007的Word呢？您正在使用2003版本，所以体验已经存在。升级到SharePoint 2007，您可以拥有协作、Word功能、文档共享等功能。
这是微软希望人们使用Office的一种方式，因此有大量文档介绍如何配置SharePoint和Office环境以支持协作。
1

谷歌在这个方向上做了一些很酷的事情：wave.google.com。这将是合作的重要一步，值得等待。

0
我们使用DocBook来编写我们所有的规范（以及其他面向客户的文档）。DocBook是一种XML格式，可以让您轻松地生成几乎任何格式的文档，包括PDF，这是我们将文件分发给客户进行签署的方式。我们可以将文档按部分分成文件，并将所有内容提交到我们的源代码控制系统（Subversion）中。因为它全部都是XML（即基于文本的），所以如果两个人在同一个文件上工作，Subversion的自动合并和冲突解决功能非常好用。我们有一套样式表，所有文档都使用相同的样式/格式，而我们不需要额外的工作。
另外，如果您不喜欢直接编辑XML文件，还有GUI前端提供类似WYSIWYG的体验。我相信我办公室的大多数人都使用XMLMind。但是，我们碰巧都是技术人员，所以如果必须直接编写XML，这也不是问题。
顺便说一下，我们还发布了版本说明。我们有一些XSLT，可以让我们编写这样的文档：
<bugs>
    <bug id="1234" component="web">JavaScript error when clicking the Kick Me button</bug>
</bugs>

我们有一个脚本，可以通过我们的Subversion存储库运行svn log，从上一个发布标记到当前发布标记，并进行一些Bugzilla集成，以便自动生成即时发布说明。
（此外，对于大多数仅内部使用的文档，我们使用MediaWiki，这也是一种很好的协作方式。）
网页内容由stack overflow 提供, 点击上面的
可以查看英文原文，
原文链接