必威体育下载克里斯蒂安·海尔曼

您当前正在浏览文档类别的存档。必威体育简介

“文档”类别的存档

解释开发人员传福音

星期二,10月21日,2008

自从我获得了“开发者布道者”的称号之后,人们斜眼看着我,想知道那是什么。人们的反应从“哦,所以你不再编码了”到“这就是营销,不是吗?”两者都错了。

我看到一个福音传道者的工作,就是在外部世界验证你的公司及其产品。这意味着你需要关注你的公司在做什么,提供反馈,阻止糟糕的文档和过于复杂的系统运行。为了达到这个目的,你需要在系统出问题之前了解它们,和他们一起玩,写或者帮助他们写文档。你也走到外面的世界,在会议上发言,到公司寻找“棕色袋子”,了解人们如何使用你雇主的产品。你从中得到的反馈可以帮助你验证或击败关于“每个开发人员需要什么”和“人们如何使用东西”的内部假设。

我在班加罗尔,当时,印度被要求为当地市场培训福音传道者。当你在公司内部发现传福音的人时,你会发现一个有点奇怪的概念——你没有训练他们成为传福音的人。

在一个两小时的会议中,我被要求概述作为一名福音传道者意味着什么,以及该做什么和不该做什么。以下是幻灯片分享的结果:

[幻灯片共享ID=674444&doc=developereVangelism-1224563721992430-9&w=425]

表扬错误

周四,5月15日,2008

我一直在和一个很多是为了让人们更好地一起工作,更快地完成工作。有一件事让我着迷,那就是人们为了避免沟通错误和问题而花的时间。

我们非常高兴庆祝成功,并指出我们所生产和所做工作的明显好处,但人们有一种固有的倾向,不愿承认错误,也不欢迎别人告诉你哪里错了。

我听过一句话“一个好朋友告诉你他们喜欢你的衬衫,一个好朋友告诉你在约会前你鼻子上有污垢”(我想是在谢尔曼的泻湖)。

犯错是件好事。他们受伤了,他们让我们思考,它们让我们生气,让我们学习。必威体育下载我们对它们所做的一件错误的事情是采取这些负面的肠道反应,并在大多数情况下以错误的方向发泄。

这就是我们的联系方式,第一个在雷雨过后发现一根燃烧的树枝的穴居人会把手伸进火里,很快就会发现这是一个糟糕的计划。然后他很可能告诉别人(他喜欢的人)不要那样做。他可能还考虑过用这把火来对付那些他不喜欢的人——可悲的是,这已经足够我们作为人类所擅长的了。

犯错误会让我们感到不充分和不安——我们作为进化之冠失败了,应该比这更好。它们也让我们感到保护——我们不想承认自己犯了错误,因为这会让我们在别人眼中显得软弱或愚蠢。这本身就是一个错误,因为我们全部的容易犯错,做傻事总是.

举个例子:当我第一次分开的清单文章被贴出来了——多年来一直是该网站的粉丝。文章JavaScript图像替换激起了彼得·保罗·科赫的强烈反对,名为为什么阿拉巴马州“JavaScript图像替换”很烂.

我被击得粉碎。PPK他的帖子指责我剽窃了他的想法和代码(我们在一个邮件列表上解决了这个谜题,用时间戳证明我两者都没有做到),他的批评在一定程度上是正确的,但在其他方面则过于热心。

我受伤了,我很困惑,很生气。我并没有抱怨打包或回击,而是查看代码并修复问题PPK谈到。我也开始和他进行更密切的交流,伟大的讨论和信息和联系人的分享。

因为我的错误,我成长了很多,而且彼此之间也没有芥蒂PPK而我——我将是在他今年晚些时候组织的会议上发言的专家之一。

简而言之,犯了一个错误,被调用并修复它使我成为一个更好的开发人员。这让我感到羞愧,也让我意识到与他人合作(即使只是为了快速检查一下自己的健康状况)比我自己更有效。

这也适用于产品:与其庆祝成功,我们应该庆祝已经引起我们注意的问题。bug是一个分析导致它修复的原因的机会。

这是真正的机会——我们必须学会不要做傻事。必威体育下载我们应该花点时间来看看错误从何而来,而不是气喘吁吁——最糟糕的情况是——提出“止损解决方案”或“快速修复”,是什么导致了它,它有什么影响,并记录修复它的方法。有数以百万计的“最佳实践”教程和示例,但没有多少“以下是我们如何修复导致这一和那一问题的讨厌的bug”文章。

原因是内疚和害怕显得软弱和容易犯错。好,我个人认为,由于你确实会犯错误,这实际上会让你变得更坚强。同样地,欣赏竞争对手的出色表现,比仅仅是胡扯自己的所作所为,表现得好像别人做不了什么,让你更可信,也是。

我很肯定,如果我们设法改变发展文化,把错误看作是积极的,我们将向前迈出一大步。一个指出明显缺陷的人并不是一个告密者,也不是一个“不发信息”的人,而是一个你必须感谢的人,因为他给了我们一个真正改进工作的机会,让我们学会了下次不要再犯错。必威体育下载

错误是好吧-它们确实会发生。

使用Tutorialbuilder从源注释生成教程

星期二,5月13日,2008

我花了太多的时间让脚本的解释教程与代码的更改保持同步。这就是我写a的原因PHP解决方案为我做这项工作。多年来,我发现解释剧本的最好方法是:

  • 展示一个例子
  • 显示完整的源代码
  • 逐位显示源代码,然后解释每个部分的功能

如果你去查一下教程建造者你会看到我用PHP脚本。它为您做了以下工作:

  • 它从脚本源代码中的注释生成教程部分。
  • 它将源代码转换为可显示代码(对其进行编码,添加行号,允许突出显示行)
  • 它使用正确的文件名创建脚本的可下载版本
  • 它创建脚本的可执行版本,而不需要使用脚本元素链接注释。
  • 它可以缩小脚本(删除所有空白以减小文件大小)

换言之,它转弯此源脚本像这样的教程使用模板和一些CSS(大部分取自YUI)。

它是一个替代JSDoc但是相反,它更容易使用和解释代码的功能,而不是JS代码本身的语法。

教程建造者许可和BSD,所以你自己动手吧。