Jeffrey Cross
Jeffrey Cross

如何为O'Reilly写一个黑客

[编者提示:这最初发布于2005年8月30日的O'Reilly网络上。]

作为O'Reilly的Hacks系列的主编,我每天都会为Hacks书籍提出建议。我通常还有几本处于收购,写作或制作各个阶段的书籍,所有这些书籍当然都有作者和(这是黑客)众多的贡献者。除了关于我们希望发布哪些主题领域的问题之外,最常出现的问题通常是主题的变化。 什么使黑客应该如何写.

我一直想为当前和未来的作者,贡献者和其他O'Reilly编辑(与他们的作者分享)编写一些内容,这些内容完全解释了我们所说的“对一个有趣问题的非显而易见的解决方案。”但是,当然,我没有时间这样做,所以我经常会经历各种各样的尝试来解释一些事情,当它到达它时,你真的需要只是想要。不幸的是,经过几次试图在这个术语上提出一个好点 (正如O'Reilly所使用的那样),我经常最终采用的描述并不比司法斯图尔特臭名昭着的淫秽定义好得多:即“当我看到它时我就知道了”。

今天,我和Paul Bausch正在讨论一个新项目,Paul Bausch已经成为该系列的模范作者(包括亚马逊黑客, 即将到来 雅虎黑客, 一个尚未宣布的第三个黑客头衔,Flickr Hacks和Google Hacks,第三版),我了解到他已经悄悄地起草了自己对这个主题的看法。 Paul是一位不太需要监督或指导的黑客格式的作者,所以我对他的观点特别感兴趣。他并没有让人失望,所以我请他与全世界分享他的圣人建议。值得庆幸的是,他同意了。这就是他所描述的那样 黑客模板:

我认为黑客是一个读者可以完成的项目。读者还需要知道他们为什么要完成项目,并了解项目完成后应该是什么样子。这是我的模板:

  1. 为什么需要这种黑客(故事,建立欲望)
  2. 描述相关功能
  3. 黑客先决条件
  4. 黑客代码/程序
  5. Hack的实例
  6. 摘要(为什么读者摇滚!)

  7. 如果可能,Hack替代方案

只要有可能,我就会使用代码的常规Hack标题和运行代码来分离第4部分和第5部分。标题为Hacking the Hack for part 7。

他的其余部分更详细地充实了他的哲学和方法。虽然如果有时间我肯定会添加一些东西,其他观点和方法肯定是受欢迎的(Hacks包含众多:它总是有各种各样的观点空间,并且包含各种观点和方法),Paul的解释和提示是这是我一直希望的开端。

如果您正在考虑为Hacks系列写作,目前正在为我们写作,或者只是希望了解香肠是如何制作的,那么您绝对不会错过它。

分享

发表评论