如果在我的软件中间，我需要解释该变量的含义和用途，则需要记录该变量。
我有JS的背景，所以我就是这样做的：
/**
* Explain what the variable is, and what is for.
* @variable {Object} nameOfVariable
*/
var nameOfVariable = []
如果是python：
# ??
name_of_variable = []
是否有这类事情的约定？
非常感谢。
参考方案
是的，这是我能找到的
https://www.python.org/dev/peps/pep-0257/
对于功能，您可以添加文档字符串，例如
def some_function():
""" Write here a one line summary.
If wanted, then leave a line and write a more detailed one"""
"""需要正确缩进才能正常工作
但是，对于散列#（在单个变量之后更常见），不需要正确缩进。例如。
some_variable = Something # This variable is doing this...
希望这会有所帮助。
Javascript + Python:将数组发送到Python脚本，将结果返回给Javascript - javascript我想建立一个网页，该网页通过Javascript API进行许多Facebook状态更新，并将它们分类到一个数组中。然后，我想将此数组发送到Python脚本，该脚本可以专门使用NLTK.进行语言分析。在Python中获得合适的结果后，我想将结果从该脚本返回到Javascript，以显示给用户等。听起来可能吗？ javascript大神给出的解决方案 是的，完…
JavaScript中的字符串评估函数 - javascriptJavaScript中是否有任何内置函数，例如Python中的eval内置函数？注意：eval函数将方程式作为字符串并返回结果。例如，假设变量x为2，则eval("2x+5")返回9。 参考方案 是的，JavaScript中也有eval函数。此外，该声明应有效用于评估，即eval("2*x+5"…
Javascript语言中是否存在python式占位符？ - javascript我有Python的经验，但是对Java语言来说还比较陌生。我知道在Python中，如果我想将一个变量替换为一个字符串（例如），我可以这样做：s = "%s:%s" % (mins, secs)但是，我找不到在Javascript中替换值的等效方法。是否存在类似的问题，还是我会以错误的方式处理？ 参考方案 在ES5中不可用，但在ES6中可用…
Javascript-从当前网址中删除查询字符串 - javascript单击提交按钮后，我需要从网址中删除查询字符串值。我可以用jQuery做到这一点吗？当前网址：siteUrl/page.php?key=value 页面提交后：siteUrl/page.php 实际上，我已经从另一个带有查询字符串的页面着陆到当前页面。我需要在页面首次加载时查询字符串值以预填充一些详细信息。但是，一旦我提交了表格，我就需要删除查询字符串值。我已…
Python-spidermonkey:如何获取行号。错误 - javascript如何检索发生错误的行号？在下一个脚本中，该行输出（作为最后一次加注的结果），但是没有行号。在JS错误对象中。from spidermonkey import Runtime, JSError runtime = Runtime() context = runtime.new_context() try: context.execute( "func…