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

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

“文档”类别的存档

讲解开发者宣传

星期二,10月21日,二千零八

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

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

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

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

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

赞扬错误

星期四,5月15日,二千零八

我一直在和一个许多为了让人们更好地一起工作,更快地完成工作,最近开发人员的数量增加了。有一件事让我着迷,那就是人们不去交流错误和问题的时间。

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

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

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

这就是我们的连线方式,第一个在闪电风暴后发现燃烧的树枝的洞穴人会把手放进火里,很快发现这是一个坏计划。然后他很可能告诉其他人(他喜欢的人)不要这样做。他可能还考虑过用这把火来对付那些他不喜欢的人——可悲的是,这已经足够我们作为人类所擅长的了。

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

举个例子:当我第一次分开的清单文章被贴出来了——多年来一直是该网站的粉丝。文章javascript图像替换引起了彼得·保罗·科赫的强烈反对,恰当地命名为什么?阿拉尔's'javascript image replacement'糟透了.

我崩溃了。PPK他是我所仰望的人,他的帖子指责我窃取了他的想法和代码(我们在邮件列表上解决了这个谜语,用时间戳证明了我确实没有做到),他的批评部分是正确的,但在其他部分则过于热情。

我受伤了,我很困惑,很生气。我并没有抱怨地打包或回击,而是查看了我的代码并解决了问题。PPK谈论。我也开始和他更紧密地沟通,这开始了很长一段时间,伟大的讨论和信息和联系人的分享。

我的错误让我成长了很多,之间没有什么不愉快的感觉PPK我——我将是他今年晚些时候组织的会议上的专家之一。

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

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

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

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

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

错误是好啊-它们确实发生了。

使用TutorialBuilder从源注释生成教程

星期二,5月13日,二千零八

我花了太多时间来保持脚本的解释教程与代码中的更改同步。所以我给自己写了一封PHP为我做这项工作的解决方案。多年来,我发现解释剧本最好的方法是:

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

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

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

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

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

教程建造者授权给BSD,所以你自己动手吧。