功能规范应该存储在哪里,如何跟踪它们的修订历史?[关闭]

1. 不要将规格以一些不常见的模糊格式存储。该工具不应指定文档的形式。这些文档可能需要由您所在组之外只熟悉Word的人使用。

2. 是的,规范/文档应该与代码存储在单独的存储库中。管理代码存储库的要求与文档存储库不同。您可以在文档存储库中使用相同的并行组织结构(即相同的项目名称、层次结构等),这应该使查找相关文档变得足够容易。

3. 每个规范/文档不应该有单独的存储库。组织应该反映代码存储库的组织。对于每个项目中的每个代码文件,是否都有单独的存储库?

4. 是的,通常在规范/文档中放置修订历史记录,而不管存储库是什么。文档可能需要跨组织使用,组织外部的人员可能无法访问源代码管理,但可能仍需要进行更改(组织中的某个人可以管理/签入)。

更常见的是,文档通常需要跨不同的公司部门使用(即,由没有访问/熟悉存储库的UI团队、销售人员、市场营销人员审查)。

在企业界,1.2。取决于存储库处理创建/访问/批准文档和代码所需的安全模型的能力。3。如果适用,您应该在文档中始终包含修订背后的深入推理。