一个糟糕的常见问题解答 (FAQ) 表格，并不是由人们实际提出的问题组成，而是由 FAQ 作者希望人们会提出的问题组成。也许您之前见过这样的类型。

这类 FAQ 的问题在于，它们从字面上讲，根本就不是 FAQ。没有人给技术支持部门打电话问：““我们如何才能最大限度地提高效率？”” 相反，人们会问一些非常具体的问题，例如：““如何更改日历系统，使其提前两天而不是一天发送提醒？”” 等等。但是，编造虚构的常见问题解答比发现真实的问题容易得多。编制真正的 FAQ 表格需要持续、有组织的努力：在软件的整个生命周期中，必须跟踪收到的问题，监控回复，并将所有收集到的信息整合到一个连贯且可搜索的整体中，以反映野外使用者的集体经验。这需要像野外博物学家一样耐心、观察的态度。这里不需要宏大的假设，也不需要有远见的宣言——最需要的是敏锐的眼睛和准确的记录。

我喜欢这本书的地方在于它正是从这样的过程中发展起来的，并且在每一页都体现了这一点。它是作者与用户互动的直接结果。它始于 Ben Collins-Sussman 的观察，人们在 Subversion 邮件列表中反复问着相同的基本问题：使用 Subversion 的标准工作流程是什么？分支和标签的工作方式与其他版本控制系统一样吗？如何查找谁进行了特定更改？

Ben 看到每天都问着同样的问题，感到沮丧，因此在 2002 年夏天花了整整一个月的时间编写了Subversion 手册，这是一本 60 页的手册，涵盖了使用 Subversion 的所有基础知识。该手册并没有声称要做到面面俱到，但它与 Subversion 一起分发，帮助用户克服了学习曲线上的最初障碍。当 O'Reilly 决定出版一本完整版本的 Subversion 书籍时，最简单的办法显而易见：只需扩展 Subversion 手册。

因此，新书的三位合著者迎来了一个难得的机会。从官方角度来看，他们的任务是从目录和初稿开始，自上而下地编写一本著作。但他们还可以获得源源不断的、不可控的、自下而上的源材料。Subversion 已经落入数千名早期采用者的手中，这些用户提供了大量反馈，不仅关于 Subversion，还关于其现有文档。

在他们撰写本书的整个过程中，Ben、Mike 和 Brian 不断地出没于 Subversion 邮件列表和聊天室，仔细记录用户在现实生活中遇到的问题。监控此类反馈本来就是他们在 CollabNet 工作职责的一部分，这也为他们记录 Subversion 提供了巨大优势。他们编写的这本书牢牢地建立在经验的基础上，而不是建立在好高骛远的沙滩上；它结合了用户手册和 FAQ 表格的最佳方面。这种二元性在第一次阅读时可能并不明显。按顺序阅读，从头到尾，这本书只是对一段软件的直观描述。有概述、强制性的导览、有关管理配置的章节、一些高级主题，当然还有命令参考和故障排除指南。只有当您后来再次阅读它，寻找解决某个特定问题的答案时，它的真实性才会显露出来：只有在遇到意外情况时才能得出的细节，从真实用例中提炼出来的示例，以及最重要的是对用户需求和用户观点的敏感性。

当然，没有人能保证这本书能回答您对 Subversion 的所有问题。有时，它对您问题的预测准确性会让人感到不可思议，但偶尔，您也会陷入社区知识的空白，空手而归。当这种情况发生时，您能做的最好的事情就是发送电子邮件到 <users@subversion.apache.org> 并提出您的问题。作者仍然在那里，仍然关注着，并且作者不仅仅包括封面上的三位，还包括许多贡献了校正和原创材料的其他人。从社区的角度来看，解决您的问题仅仅是一个更大项目的一个愉快副作用——即逐渐调整这本书，最终调整 Subversion 本身，使其更贴近人们的实际使用方式。他们渴望听到您的意见，不仅是因为他们可以帮助您，而且因为您可以帮助他们。对于 Subversion，就像所有活跃的自由软件项目一样，您并不孤单.

让这本书成为您的第一位伴侣。