侯捷 1998.01.18
我曾经在【无责任书评】中介绍过Windows/DOS Developer's Journal。这是一本技术层面偏低阶的期刊，每个月大约只70~80 页，但内容非常扎实。一本刊物如果胆敢每期维持在极少的页数，你最好多注意一点，那通常表示刊物的维它命单位含量很高。
这本期刊早已在 1995/10 改名为Windows Developer's Journal，以下我以 WDJ 称呼之。此期刊在 Windows 低阶技术面与对岸高阶的Microsoft Systems Journal（MSJ）遥相呼应，互为瑜亮。收到 WDJ 和 MSJ 永远是我每个月的快乐时光。喜爱低阶技术的工程师朋友，大概对 WDJ 不会陌生，里面常常出现的主题有 Windows NT kernel mode driver、Windows 95 VxD、MFC tips，固定的专栏则有Bug++ of the Month（每月烂苹果奖）、Tech Tips、Understanding Windows NT、Books in Brief。
Books in Brief 是我最喜欢的一个专栏，因为这是个书评专栏，与我气味相投。主持人 Ron Burk 是 WDJ 的资深编辑。并不是每篇书评都由他执笔，有的是读者来函，有的是特约邀稿。Ron Burk 的阅历与机锋，侯捷不及也；他的犀利，也超过我多多。我记得有一期专栏刊出一位读者（或特约编辑？）的辛辣书评，引来原作者的回骂，於是评者、作者、编者三人在杂志上对干起来，霎时飞沙走石，惊天动地，言词尺度令人捏一把汗！
1998/01 WDJ 有一篇 Ron Burk 所写的 "Guide for Book Authors"。我觉得很有趣，又颇符合最近风起云涌、惊涛裂岸的国内电脑书市，所以将它翻译出来，并加「★侯子赞曰」，以飨读者。我必须先说明，由於 WDJ 是一本讲 Windows 程式技术的期刊，所以 Burk 在文中对着他的读者讲话，说到电脑「技术」，都是以 Windows Programming 为代表。
Burk 文中所说的情节，轻重程度或因国情而不同，不过呢，我要说，【无责任书评】长久以来对於电脑书籍大环境的批评，原来「非兄弟我所独创」，实海内存知己呀。
以下就是 Ron Burk 所写的 "Guide for Book Authors" 全文。
企图以「老是出版一些渣滓劣物」的评语来羞辱一个书籍出版商，大概对於整个电脑书籍的大局无济於事。我或许应该从作者这边下手。
★侯子赞曰：其实不会无济於事！最近经过读者、网友的努力，造就了「良币驱逐劣币」的历史反动，迫使国内一家规模不小的电脑出版公司关门！
如果你想写一本 programming 书籍，请考虑以下数点：
1. 不要因为出版商拿出一张合约，你就被冲昏了头。拿一张出书合约就像申请一张信用卡一样简单 -- 那只是字面真理而已。别忘了迩来出版商常在 Internet 上以各种理由发出「诚徵作者」的讯息。出版商印一张合约给你，一点成本都不必花，因为他们很少会支付预约金 -- 如果你是第一次写书而且他们够机伶的话。万一他们支付预约金给你，也请你认清一件事实：预约金就是预支金，将来要从版税中扣回来的。如果你的书最终没有出版，或是出版了但没有卖到足够的量，出版商会要你开一张支票，把差额补过来。
★侯子赞曰：给你一张合约，至少还算依法行事。那种光凭口头说说，不立文字的劣等厂商，则属教化之外！网路上看到年轻学子被不肖出版厂商恶意欺负，以至於做白工、投诉无门，真令人难过。
2. 请你了解，写书的收益，比在麦当劳打工高不到哪里，除非你是粗制滥造的高手。有些人真的能够一个月内完成100 页垃圾，出版商再把每 1 页垃圾扩充为 4 页垃圾，一本书就出来了。这就是他们的特异功能。注意，合约上说你将收到 10% 的版税，但并没有精确指出是什麽的 10%。真的，你签定的是 X 的 10%，而 X 并没有在签约时设定好。镇日在逻辑圈中打滚，我们程式员成了很容易受骗的一个族群。相信我，X 绝不会接近你所期望的数字。虽然我们（侯捷按：指的是 WDJ 杂志）所付的稿费不多，但要比写一本书的所得更多，绝不困难。顺带提醒你，如果你必须签下这样一纸合同，除了千万不要低於 10%，尤其要注意版权的归属。这样，在出版商没有把你的心血结晶成功地推到市场时，你至少还保有你的工作成果。
★侯子赞曰：下面这段话是一位很用心的技术书籍作者写给我的，可做为某种心声的代表：「与教电脑付出的时间与心力相比，写书真是考验智力、体力、毅力的工作。真要赚什麽钱的话，就不写书了，其他门路还更快更有效些，坦白说！」
3. 试着残忍地、诚实地评估你是否真的有什麽东西要发表。现在开始列出一些不容易在标准文件或 MSDN CD-ROM 上获得的技术。如果你的列表有 10 页长，我想你的确适合写本书。如果只有两页长，这本书太薄了点，不是吗？
★侯子赞曰：我个人比较没有用这麽严苛的眼光来看待一本programming 书籍。书写的好，不常常是因为作者有什麽独到技术，而常常是因为作者整理得好 -- 在范例、文字、动线、组织、图表、资料收集...各方面。
4. 为你自己找一位技术编辑。技术编辑（tech. editor）和技术检阅者（tech. reviewer）有很大的不同。所谓技术编辑，是那种有丰富的编辑经验，又有足够的技术基础，知道你在写什麽的人。这种人很难找，而且不便宜。你需要这样的人给你忠告，告诉你如何以最佳方式组织这本书、决定这本书应该有哪些主题、应该舍弃哪些主题、并且在你懒散下来，开始出现许多「留给读者练习」而其实应该由你完成的小节时，给你一些鼓舞和一些当头棒喝。『啾多嘛爹』，你说，『出版商不是应该提供一位技术编辑给我吗？』认清事实吧，你的出版商有数以打计（甚至百计）和你一样的未成名作者，他们并不打算在你身上投资一块钱，除非（直到）你交出你的稿子。投资金额嘛... 当然是愈少愈好。你应该花多少钱来聘请一位技术编辑呢？唔，这是个难以回答的大问题，不是吗！这也可以解释为什麽市面上有这麽多电脑书不值钱。如果你认为你不需要一位技术编辑，我认为你是在欺骗自己，很快你的书就会被扫到垃圾堆的一角。
★侯子赞曰：呵欧，呵欧，技术编辑，这实在太难了。国内连「同僚覆审」（peer review）制度都还没有建立起来呢！前两天网友 kennybn 说排版：『出版社的排版经费有限，除非作者自己愿意贴钱，不然以每页 70~100 的价格，老实说，我认识一个很强的美工，我都不好意思拿这种等级的钱侮辱他』。重要性更甚的书籍技术编辑，到底该花多少价码才不会侮辱他呢？困难唷！
5. 为你自己找一位文字编辑。出版商不愿意花钱投资一个够格的技术编辑，这我早就知道了。但最近我才确知，他们甚至连文字编辑也不愿意投资。我简直被吓到了！程式员交去的稿子，他们似乎完全未经处理就直接上马，连一回合的检查都没有。文字编辑不需要了解 Windows programming，但是他们了解清晰的、简明的、前後一致的文字风格。如果你在某一段一开始说 Win95 不支援 volatile registry key，结尾时却说它们可以在 Win95 中被产生出来，你的文字编辑会把它挑出来。他们会精简你那些虚浮空泛的语句，甚至可能挥挥手要你把整个句子重写。你应该花多少钱来聘请一位文字编辑？唔，这又是作者的一道难题了！如果你认为自己不需要一位文字编辑，那麽请就近到任何一家书店，看看那些文字漫不经心的书籍。如果你猜想你的出版商会提供一位文字编辑，不妨故意留下一些错别字以及一些前後不一致的句子，看看它们会不会被更正。小心，你可能会被吓到。
★侯子赞曰：在资讯人（甚至科技人）的文字水准普遍低落的今天，电脑书籍或文章的文字编辑非常重要。请看看那些句子不像句子、虚字不像虚字、文言不像文言、白话不像白话的 programming 书籍，随处都有，俯拾可得。拿针毡放在你的屁股下，拿芒草刺你的背，很痛苦吧，没办法，要吸收那些人的知识，要得练就这种功夫。其实转换一下心情，你也可以得到快乐。我每次阅读国内某几位知名作者的文字，都感觉经历了一种另类「享受」：极端痛苦之後一种劫後馀生的幸福感。
6. 学习如何做研究。如果要写一本书，动手吧。但如果要写一本掷地有声的好书，请你先做点研究。最起码，把MSDN CD-ROM 以及任何相关的 programming 杂志的过期本都买回来。好好研究一下你所要涵盖的主题，并确实读过其他一些相关着作。它们好在哪里？它们烂在哪里？这些资讯对你的书都极有价值，也是制作 bibliography（叁考书目）的素材。你不可能写一整本书却没有引用任何叁考资料，对吧！我说个故事给你听，我发誓这是绝对真实的故事：一位知名的 programming 书籍作者在书店中翻阅一些 programming 书籍...
知名作者：『我想我的书大概不够理论、不够学术。』
路人甲：『何以见得？』
知名作者：『唔，我写了不少书，但是都没有人在他们的叁考书目中提过我的书！』
路人甲：『你在你的书中引用了哪些书呢？』
知名作者：『唔...呃...喔...我好像没有叁考任何其他书籍。』
★侯子赞曰：学术作品绝对不敢忘记 bibliography 或reference。在比较松散的非学术作品中，这的确是为人忽略而亟需加强的一点。
7. 写作之前，请先对你的书的市场有所计划。出版商当然至少会处理市场方面的问题，不是吗？不，这是致命的错误想法唷！你的出版商对你的书的技术内容，抑或对你的读者的特性，不可能比你更了解。信不信由你，你对於自己的书籍的市场性的了解，绝对比你的出版商多得多。你可能比较知道什麽样的人适合收到 review copy，甚至哪些人的review copy 最好由你亲自送。我没有办法告诉你一个作者是否曾被告知他们的书籍会被送到我这里（侯捷按：指WDJ 杂志的 Books in Brief 专栏）来检阅，不过我可以告诉你，我们从来没有收过这样的东西。这一类事情一定会让身为作者的你感到惊讶：版税以外的其他 90% 的钱到底是如何分配？
★侯子赞曰：我真不知道一个第一次写书的作者，提出他对市场的种种想法，包括怎麽做广告、怎麽推广、怎麽搭配其他产品等等，会得到出版商怎样的回应。我猜想是「你算老几？」
我的这些建议听起来对於写作都不是一种鼓舞。是的，的确！我们现在身处的情况是，80% 的 programming 书籍并没有符合一个合理的起码品质。如果作者们很容易就能产出一本够水准的书，情况当然不会如此。大部份作者都想把事情做好，但是他们不知道怎麽做，也没有获得应有的机会。现在，让我提供一个至少听起来令人稍感鼓舞的建议：如果你坚决想要尝试写一本 programming 书籍，试试O'Reilly & Associate（www.ora.com）。虽然截至目前Windows programming 不是他们的主攻项目，但他们已经比其他我所知道的任何一家出版公司做出了更好的成绩。此外，Andrew Schulman，以我个人的看法，是位非常优秀的技术编辑，属於极度稀见的那种等级。如果你能够在O'Reilly 出版你的书，并且让 Andrew Schulman 担任你的技术编辑，你的胜算可以说是大大获得了提升。我对O'Reilly 的财务没有兴趣知道，Andrew Schulman 於我也只是点头之交。我只是希望，堆在书店中的大烂书愈来愈少。
附记：读者来信问我为何多月未见在杂志上发表文章。感谢关心。侯捷两个月前打乒乓球伤了右手中指，草上飞变成九指残。现在情况恶化，更被医师强制载上指箍，好像机器战警，酷的！
此文以九指神功完成，志於斯以为念。-- the end