一本糟糕的常见问题解答 (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 的所有问题。有时，它对你的问题的预测精确度会让人感到毛骨悚然；但有时，你也会偶然发现社区知识中的漏洞，最终空手而归。遇到这种情况时，最好的做法是发送电子邮件到 <[email protected]> 并说明你的问题。作者们仍在那里，仍在观察，并且作者不仅包括封面上的三位作者，还包括许多为本书提供修正和原创材料的其他人。从社区的角度来看，解决你的问题仅仅是更大项目的一个愉快的副作用——即慢慢调整这本书，最终调整 Subversion 本身，使其更符合人们的实际使用方式。他们渴望听到你的意见，不仅因为他们可以帮助你，而且因为你也可以帮助他们。对于 Subversion 以及所有活跃的自由软件项目来说，你并不孤单.

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