language-agnostic - 解释一个概念 : Does showing code early make it clearer?

Question

我想这是一个可能很多人感兴趣的问题，所以请讨论! :-)

现在，假设您想向人们展示您使用的 future 开发概念(例如您想要介绍的新产品或新技术)。

尽早展示代码有意义还是先看PPT？或者你会推荐什么？

Answer 1

+1 给 Stijn，因为真的，这才是最重要的。

但是，这真的取决于你在做什么。你的“概念”是什么？

API(例如 mapreduce)？

展示 API 的代码，不要在实现代码上浪费人们的时间，这并不重要——“嘿，看看我是如何迭代你的输入的!太聪明了!”。没有。没人在乎。如果你的 API 很棒，它就会被使用，没有人会关心代码是多么糟糕才能让它工作。

产品(例如 Facebook)？

显示代码？没人在乎。甚至 facebook 都不在乎(如果他们这样做了，他们为什么要使用 php？我的 child !)。半完整原型(prototype)的演示让他们大吃一惊，该原型(prototype)在一些事情上做得很差，但展示了它有多么出色。

实现本身(例如，一个新的 std::sort 例程)？

很多人可能有兴趣看到内脏。特别是SO上的人。所以，当你得到一些工作时，发布代码或白皮书。这不是“我的 twitter 克隆会很可爱，看看我的 TruncateTo140Chars() 功能有多酷!”。另一方面，您可以通过展示您的算法(在代码或伪代码中)获得有关新实现方法的快速反馈。您可以显示基准，这比“这段代码应该更快，因为我少做一个与零比较”要好。

请只是原型(prototype)，得到一些你的用户会关心的演示。如果这是您的用户想要看到的(通常不是)，只需担心代码。