asciidoc - 对一个 AsciiDoc 文档使用多个文件有什么好处？

Question

我们正在考虑使用 Asciidoc 来创建用户指南，我们打算只在 github 上对单个文件进行版本控制。

然而，我们看到，像 ProGit ( https://github.com/progit/progit2/tree/master/book ) 这样的已建立项目虽然也生成单个文档，但将 Asciidoc 拆分为多个文件。

将一个逻辑文档拆分成多个文件有什么好处？

Answer 1

我认为使用多个文档的最大优势在于组织和精神上。假设您有每个部分的文档，如果它在自己的文档中，则查找和修复或添加到一个部分要容易得多。当您打开较小的文档时，与打开较大的文档相比，它也更容易在精神上消耗和思考。如果您打开一个文档并且滚动条开始变得越来越小，您就会开始考虑需要多长时间才能找到您需要更改的内容、是否值得进行更改以及加载需要多长时间。当然这些都是主观的，也许有些人没有这个问题。

使用多个文档的另一个很好的理由是，如果在将来的某个时候您决定拆分每个部分/章节，那么从多个文档开始并将它们包含在一个大文档中比之后尝试将其切碎更容易。

除了组织问题之外，如果您有多个人在处理一个文档，那么与一个大文档相比，在一个较小的文档中更容易看到更改。