本手册旨在描述 Subversion 1.1。如果您使用的是更新版本的 Subversion,我们强烈建议您访问 https://svnbook.subversion.org.cn/,并查阅适合您 Subversion 版本的书籍。
糟糕的常见问题解答 (FAQ) 并非列出人们真正提出的问题,而是 FAQ 作者希望人们提出的问题。也许你之前就见过这种类型
问:如何使用 Glorbosoft XYZ 来最大化团队效率?
答:我们的许多客户想知道如何通过我们专利的办公协同软件创新来最大化效率。答案很简单:首先,点击“文件”菜单,向下滚动到“提高效率”,然后……
这类 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 本身,使其更接近人们实际使用的方式。他们渴望听到您的意见,不仅仅是因为他们可以帮助您,而且因为您可以帮助他们。对于 Subversion 以及所有活跃的自由软件项目来说,您并不孤单.
让这本书成为您的第一位伙伴。
—
,芝加哥,2004 年 3 月 14 日