4

我正在与一个地理上分散的开发人员小团队（另外 2 个）合作，我正在寻找我们在规范方面进行协作的好方法......我们认为我们可以使用 Google Docs 来编写规范我们都可以在一个中心位置对其进行修改。

你做了什么？你有什么好主意？

4

7 回答 7

2

Google Wave - 正是它的意义所在 - 协作

于 2009-11-04T16:39:49.190 回答
2

恕我直言，文字处理器对程序员来说是错误的工具。规范应该用纯文本编辑器编写，并使用轻量级标记，例如 reStructuredText、AsciiDoc 等。

这种方法的好处是：

  • 管理纯文本的优秀工具已经在程序员手中（VCS、自动构建系统、差异、补丁、编程编辑器、grep 等）
  • 标记语言允许表达意图而不是格式化。

考虑到这一点，Wiki 似乎是显而易见的选择。

我个人选择的工具链是：

于 2009-11-04T16:43:54.033 回答
2

如果您有 Intranet 或 VPN，我实际上会考虑为这些规范安装和使用小型 Wiki。

与您获得的 Google 文档相比：

  1. 更好的版本控制和变更跟踪（恕我直言）
  2. 为小节开始新文档要容易得多
  3. 一个实际的标记而不是所见即所得（一个口味问题，我更喜欢 LaTeX 到 Word）。
  4. 可以附加各种其他文件类型
  5. 非常容易备份
  6. 很容易创建离线版本
  7. 您不必担心将敏感材料存储在其他地方。

缺点是它不是所见即所得，这对您来说可能是也可能不是问题。

当然，您可以选择支持更好的编辑器的 Wiki 实现，甚至可能是同步协作的。

于 2009-11-04T18:44:53.580 回答
1

技术的选择是一个问题，恕我直言，谷歌文档是一个不错的选择。但真正的挑战是如何管理流程，例如划分任务。

我的建议是首先确保平台和所有相关技术都尽可能地确定。然后，编写一个完整的目录。精心设计的 TOC 将允许您正确划分任务，而不是“踩”对方的工作。从那时起，你们每个人都会“充实”分配给你的部分，并审查彼此的工作。

实际上，每个 TOC 子部分都成为一个原子工作单元，可以由对所述部分负责的个人分配和维护。

祝你好运！

于 2009-11-04T16:38:50.260 回答
1

我认为这取决于

  1. 你们在编写规范方面有多投入
  2. 如果你可能同时写作
  3. 您是否打算发布规范。

Google Docs 很好用而且很容易上手。您现在可以一次导出所有文件夹也很棒。尽管如此，对于将要发布到网络上的内容，wiki 或通用 cms 是更好的演示工具。wiki 也将与您现有的站点集成。

如果您有小规格，主要由一个人编写，那么请使用您托管项目代码或网站的任何可用工具。如果您不太可能同时进行编辑，那么 wiki 是不错的选择。

我已经完成了 wiki 的事情、传递的文档的事情和 Google Docs 的事情。

  • wiki 的东西起步很慢，而且持续时间很长。在一定大小时，它确实会很痛苦。
  • 传递的文档内容（写入、电子邮件、编辑、电子邮件等）仅在一个人启动所有内容时才有效。只要有一些小的编辑，那就糟透了。
  • 在您拥有多个文档和多个编辑器或想要在线发布之前，Google Docs 的东西很好。

hth

于 2009-11-05T01:22:30.247 回答
0

这与编程无关，但我个人使用 Google Docs 编写共享文档并发现它易于使用。

但是，我建议启用 Google Gears，以防 Google 服务器暂时停机或互联网连接不可用。

于 2009-11-04T16:32:38.767 回答
0

对于协作编写规范，您可以尝试Gingko。

它是一个卡片树编辑器，这意味着它是索引卡片和大纲工具的混合体，具有实时协作和完整的 Markdown 支持（以及基本的 LaTeX）。

我们仍然缺少一些功能（版本历史、评论等），但对于某些人来说，将所有内容都放在树形结构中的好处超过了这些缺点。

用它编写规范非常棒，因为您可以为每个用户故事创建一张卡片，并随心所欲地深入研究它（如果您愿意，可以将它们组织成类别）。

http://gingkoapp.com

于 2014-06-25T09:53:51.893 回答