电力的历史令人着迷。 从人们第一次遇到“静电”开始，就是将两种材料摩擦在一起，直到本杰明·富兰克林的风筝被雷击，最后发明了灯泡。 允许所有这些发现和创新发生的关键因素是什么？ 通讯。 您可能已经听过伊萨克·牛顿（Issac Newton）的这句名言：“如果我进一步了解，那就是站在巨人的肩膀上”。 无论是通过口口相传还是书面形式，除非我们想从一遍又一遍开始，否则必须传递思想。 试想一下，如果托马斯·爱迪生（Thomas Edison）之前没有做过任何工作来使他的灯泡立足于：我们可能不像今天那样！
在编程应用程序中，重要的是要利用“站在巨人的肩膀上”的想法。 为了使这种情况发生，重要的是我们必须清楚地交流我们的想法，以便将来可以理解我们的工作。 在代码中，这可以通过添加文档或文件本身中的注释来完成。 不过，在讨论评论之前，让我们先考虑一下翻译内容是什么样的。
- 欢迎来到丛林：音乐流媒体的现状
- 播放列表策展人寻找的四个要点–史蒂芬·西里诺（Stephen Cirino）
- SpotifySerenade / 2016年5月的Canciones de Mayo
- 愚蠢
- 第五：：阅览室
您是否曾经读过别人的笔迹，却不知道他们写的是什么？ 如果您还没有，我希望您继续祝您好运。 对于那些经历过这种情况的人来说，当您处于沉重的笔记课中时，情况甚至更糟。 教授每分钟写一英里，你几乎不能翻译她/他写的东西，更不用说跟上了！
现在，假设我给您发了条注释，上面写着“ op aolyl”。 消息说什么？ 继续，我给你几秒钟。
你是什么意思，你不知道笔记里说了什么？ 哦。 我忘了告诉你，我将原始消息中的每个字母都移了7以得到消息“ op aolyl” 。 因此，“ h”转换为“ o”，“ i”转换为“ p”，依此类推。 如果将“ op aolyl”中的每个字母向后移7个字母，您将得到原始消息： “ hi there” 。 如果您很好奇，这种“翻译”称为凯撒密码。
当然，如果我告诉更多的信息，我相信您可能已经明白了这一点：“我在此消息上使用Caesar Cipher并偏移了7”。 知道了这些信息后，就很容易理解正在发生的事情。 要将其与编码相关联，可以想象您将来会看别人的代码，甚至看自己的代码。 如果没有任何评论可告诉您发生了什么怎么办？ 该代码也可能看起来像以前的“ op aolyl”消息，而没有必要的信息来解密它。 如果有足够的时间，您可能可以弄清楚发生了什么，但是如果您首先有意见要告诉您，那会很好。
好吧，所以交流对于思想的传播很重要。 代码看起来如何？
这是Spotify Voice的一个很小的代码片段，可将曲目添加到列表中。 如果没有评论，则可能需要30秒钟才能解决，但是有了评论，您马上就会知道它的作用。 这是一个简单的示例，但是您可以想象，当代码变得更长且更复杂时，最好有注释来解释逻辑。
当您注释代码时，您不仅在帮自己一个忙，而且在其他需要与您的代码进行交互的人身上也很忙。 有时候很难停下来并记录下您所做的事情，但是将来可以节省很多时间，最好花在看像这样的狗gif上。
归根结底，注释代码是乏味且费力的工作，但是当您返回项目并想知道您正在查看的代码到底在做什么时，它会在将来获得巨大的回报。
Madeon开启的[Spotify] [YouTube]
