Python 这段谷歌代码中括号内的开始/结束注释的目的是什么？

发件人：

---

谁能告诉我这些是干什么用的吗？它们看起来像是编辑器提示，或者是一些自动文档，但我找不到相关信息。

看起来“user2357112支持Monica”的答案是正确的（谷歌内部）文档系统似乎使用这些部分边界将相关代码示例提取到文档中。

这是一条注释。。。最重要的是要有某种代码解释……看起来这只是程序员的个人风格。在线文档似乎使用这些标记来知道要嵌入文件的哪些部分。您不需要在代码中执行类似的操作。例如，DOM检查显示Python示例具有

数据github path=“GoogleCloudPlatform/Python docs samples/compute/api/create_instance.py”

和

数据区域标记=“create_instance”

，并且它嵌入了由

分隔的
create_instance.py
部分[开始创建_实例]

和

#[结束创建_实例]

。

# [START list_instances]
def list_instances(compute, project, zone):
    result = compute.instances().list(project=project, zone=zone).execute()
    return result['items'] if 'items' in result else None
# [END list_instances]