0

我将项目文档理解为软件项目演变的一部分，有时与代码联系在一起（尤其是在精益方法中）。这就是为什么我认为将它与修订控制系统中的代码（例如 git，在我的例子中）保持在一起可能是一个好主意。

Markdown 似乎是一种广泛采用且有效的协作编辑文本文档的解决方案。但是，当涉及到实体关系或序列图时，我不知道要使用哪种格式/软件，因此仍然可以进行差异和合并。

所以我的问题是：

  • 将代码和文档保存在同一个存储库中实际上是个好主意吗？
  • 如果是，您会使用哪种格式的图表？

我目前正在考虑一些文本 UML 图表工具，但我想知道您的意见。提前致谢！

4

3 回答 3

3

免责声明：我是 EMF 比较项目负责人

在 Eclipse 世界中，EMF 比较项目通过为任何类型的模型（它专门针对 UML 模型和图表）提供逻辑差异、合并和冲突检测来解决该问题。

它适用于 XMI 文件（但不限于）并与 Eclipse 团队支持（CVS、SVN，尤其是 GIT）集成，确保模型即使在多个文件中拆分时也始终保持一致。

于 2013-01-08T20:47:49.737 回答
0

关于谵妄的权利

基于公理

XML 元数据交换 (XMI) 是一种 OMG 标准，用于描述以 XML 格式存储 UML 模型的结构。

如果您能够找到任何可以导出/导入 XMI 的工具（就像UML 的 Visual Paradigm所做的那样），您可以

  • 使用 UML
  • 在 SCM 级别存储、版本、处理 XMI 文件
于 2013-01-08T18:03:49.743 回答
0

OMG 为 UML 图（http://www.omg.org/spec/UMLDI/）定义了一种格式，但我想很多工具都没有实现它......实际上每个 UML 工具都有其内部图表表示，所以解决方案您的问题将在很大程度上取决于所使用的技术。如果模型和图表都以 XML (XMI) 格式形式化，例如基于 Eclipse-EMF 的工具Topcased或 Together，我想您可以直接在文件上使用 GIT 或更高级的工具，例如 EMF Compare。如果您使用另一种工具，例如 RSx 或Modelio，它们有自己的控制版本服务。

于 2013-01-10T10:52:03.600 回答