如何为拆分库组织存储库？

Question

我有两个实现协议的库:一个提供在两个部分之间建立通道的工具，另一个提供构建和解析二进制协议消息的类和工具。

这两个库可以独立使用，它们不相互依赖，而且每个库都有自己的构建设置。但是，它们确实共享了一组共同的示例(同时使用库)和文档(教程)。

对于在Git存储库中组织这一工作，我有两个备选方案：

备选方案1

使每个库都位于自己的存储库中。中央存储库将保存用于克隆存储库和引导存储库的通用文档、示例和工具。用户将使用这个主存储库，而开发人员将使用专用的存储库。

我不想使用Git子模块，因为它们很难以这种方式管理(当库不断变化时，版本控制变得更加困难)。

备选方案2

把它放在一起:库、文档和示例。版本控制将应用于两个库，因为它们将被视为一个(尽管是分开的)实体。

我们现在就是这样做的。它使事情变得更简单，但我觉得它可以改进。

所以..。使用Git组织这一切的最佳实践是什么？我也有其他的选择。

尽管我们现在没有使用它，但是我们可能会使用持续的集成工具、自动化测试和构建等等。

Answer 1

应该组织源代码存储库(即git或其他vcs)，以方便那些从事源代码工作的人；修复、扩展和发布源代码。

二进制存储库(即Debian、基于maven的存储库等)为方便与图书馆合作的人而组织。

有时，在短期内，您使用源代码存储库向最终用户提供东西，仅仅是因为其他任何东西都会导致过度死亡。在这种情况下，从定义上来说，不值得为了方便而对事物进行重新组织；你所做的要么太简单，要么用户太少。如果这种情况发生变化，则设置二进制存储库，而不是重新组织。

正如您所说的，您希望将这两件事合并在一起，这意味着只有一个存储库。而且，由于性能原因，它听起来并不大到您想要拆分存储库的程度。