一篇糟糕的常见问题解答 (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 的所有问题。有时，它预测你问题的精确程度会让你觉得毛骨悚然；但有时，你会偶然发现社区知识中的漏洞，最终一无所获。当这种情况发生时，你能做的最好的事情就是发送电子邮件给 <users@subversion.tigris.org> 并提出你的问题。作者仍然在那里，仍然在观察，他们不仅包括封面上的三位作者，还包括许多其他贡献了更正和原始资料的人。从社区的角度来看，解决你的问题只是更大项目中令人愉快的副作用——即慢慢地调整这本书，最终调整 Subversion 本身，使其更贴近人们实际使用的方式。他们渴望收到你的来信，不仅仅是因为他们可以帮助你，而是因为你可以帮助他们。在 Subversion 以及所有活跃的自由软件项目中，你并不孤单.

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