一份糟糕的常见问题解答 (FAQ) 列表，不是由人们实际提出的问题组成，而是由 FAQ 作者希望人们提出的问题组成。也许你以前见过这种类型

这种 FAQ 的问题在于，从字面上讲，它们根本不是 FAQ。没有人曾经打过技术支持电话，问过，“我们如何才能最大限度地提高效率？”。相反，人们问了非常具体的问题，比如，“我们如何更改日历系统，以便在提前两天而不是一天发送提醒？”等等。但是，编造虚构的常见问题解答比发现真实的问题容易得多。编制一份真实的 FAQ 列表需要持续、有组织的努力：在软件的整个生命周期中，必须跟踪传入的问题，监控响应，并将所有收集到的信息整合到一个连贯的、可搜索的整体中，以反映用户在野外使用时的集体经验。它要求像野外博物学家一样耐心、观察的态度。这里没有宏伟的假设，没有远见卓识的声明——最需要的是睁大眼睛，准确记录笔记。

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

Ben 对每天看到相同的问题感到沮丧，因此在 2002 年夏天花了一个月的时间写下了 Subversion 手册，这是一本 60 页的手册，涵盖了使用 Subversion 的所有基础知识。该手册并没有假装完整，但它与 Subversion 一起分发，帮助用户克服了学习曲线上的第一个障碍。当 O'Reilly and Associates 决定出版一本完整的 Subversion 书籍时，最轻松的路径显而易见：只需扩展 Subversion 手册即可。

因此，新书的三位合著者迎来了一个不寻常的机会。在官方上，他们的任务是从目录和初稿开始，自上而下地写一本书。但他们也有机会获得源源不断的——实际上是不可控的喷泉——自下而上的素材。Subversion 已经落入成千上万的早期采用者的手中，这些用户不仅对 Subversion 本身，还对现有的文档提供了大量反馈。

在他们写这本书的整个过程中，Ben、Mike 和 Brian 始终密切关注着 Subversion 邮件列表和聊天室，仔细记录着用户在现实生活中遇到的问题。监控此类反馈是他们在 CollabNet 的工作职责的一部分，当他们着手记录 Subversion 时，这给了他们极大的优势。他们制作的这本书牢牢地建立在经验的基础上，而不是建立在愿望的流沙上；它结合了用户手册和 FAQ 列表的最佳方面。这种二元性可能在第一次阅读时并不明显。按照顺序，从头到尾，这本书只是对软件的简单描述。有概述、强制性的导览、关于管理配置的章节、一些高级主题，当然还有命令参考和故障排除指南。只有当你后来回到这本书中，寻找某个特定问题的解决方案时，它的真实性才会显现出来：只有在遇到意外的情况下才能产生的细致入微的细节，从真实用例中提炼出来的示例，最重要的是对用户需求和用户观点的敏感性。

当然，没有人能保证这本书会回答你对 Subversion 的所有问题。有时，它预测你问题的精准程度会让你感到毛骨悚然；然而，偶尔你也会偶然发现社区知识中的漏洞，然后空手而归。当这种情况发生时，最好的办法是发送电子邮件到 <[email protected]> 并描述你的问题。作者仍在那里，仍在观察，他们不仅包括封面上的三位作者，还包括许多其他贡献了修正和原始资料的人。从社区的角度来看，解决你的问题只是更大项目的一个令人愉快的副作用——即缓慢地调整这本书，最终调整 Subversion 本身，使其更接近人们实际使用的方式。他们渴望听到你的声音，不仅仅是因为他们可以帮助你，还因为你可以帮助他们。与所有积极的自由软件项目一样，你并不孤单.

让这本书成为你的第一个伙伴。

— Karl Fogel，芝加哥，2004 年 3 月 14 日