Zh-hans:Key:comment
Warning: Default sort key "comment" overrides earlier default sort key "Key:comment".
 changeset 键: comment
|
 |
| 说明 |
|---|
| 为其他制图者而非本人提供的一个变更集说明。 |
| 组: changeset |
| Used on: |
|
| Status on changesets: |
| 实际使用 |
作为变更集键
comment 标签用于描述变更集，它是在 API 0.6 期间引入的。它是制图者用来描述自己做了什么、或者更有意思的是——为什么做出这些更改的一种方式。例如，当一个标注了 highway=bus_stop 的节点被移动时，变更集注释可能是“moved bus stop after recent roadworks”（在近期道路施工后移动了公交站）或“moved bus stop, was in wrong place”（移动了公交站，原先位置不对）。这有助于向其他制图者解释为什么做出某些特定更改。
comment 标签显示在网站上的多个位置，尤其是在历史记录选项卡以及其他涉及变更集的视图中。变更集注释并非强制要求。变更集注释是给其他制图者的一条信息，告诉他们你做了什么以及为什么。因此，有意义的信息体现了对其他制图者的体谅。
有些人认为，不花时间添加这样的信息，或者添加无意义的注释，是粗鲁或不尊重的行为。另一方面，许多变更集注释甚至可能根本不会被阅读，有些人认为花时间做几乎没人会看的事情是浪费时间，宁愿把时间用来改进地图数据。
有关最佳实践，请参见 Good changeset comments。
OpenStreetMap 中其他 “comment” 文本
在 OpenStreetMap 中还有其他多种留下自由文本的方式，用于与其他制图者交流。
其他常用的键有……
note=*– 用于给你自己和其他制图者添加备注。description=*– 用于添加可能对最终用户可见的文本。fixme=*– 标记需要进一步关注的对象和地点
这些通常用于节点/路径/关系上来描述现实世界中的事物，例如“the busstop is actually here but the signpost was knocked down in september 2009”（公交站实际上在这里，但站牌在 2009 年 9 月被撞倒了），而 comment 标签则用于变更集。
变更集讨论可以围绕某个特定变更集展开。多个用户之间来回讨论，讨论的主题是该变更集中所做的更改。变更集讨论可能会与变更集注释混淆。一个变更集只有一条注释，由做出更改的人撰写（如果留空则没有注释）
备注是一种非常简单的机制，允许任何人（甚至未登录的网站访客）在地图上的特定位置留下一点自由格式的文本，描述地图存在的问题或需要补充的缺失数据。备注不依附于节点/路径/关系或变更集。它们只是放置在某一个位置上。
当然还有许多其他联系渠道。任何与另一位制图者的深入讨论，你都应该转移到这些更合适的渠道。另请注意，所有发布自由格式文本的机会，同时也是彼此以礼相待的机会！另见 Community Code of Conduct (Draft)
开发者指南
尤其是关于变更集：
- 注释标签不应自动生成。如果数据消费类项目希望获得自动化数据，它可以自行计算。
- 注释标签不是强制性的——例如，某个编辑器的工作流程可能不适合添加注释（参见 Potlatch (v1.x) 实时模式）。然而，有意义的变更集注释非常有用，因此编辑工具让制图者容易添加注释是个好主意。如果你的软件强制要求添加注释，你可能会发现一些制图者会以消极的方式回应，输入“garbage”（垃圾）注释。
- 如果用户想使用注释标签，编辑器中应提供该功能。
作为键
| comment
|
 |
| 组: annotations |
| 用于这些元素 |
|---|
    |
| 另见 |
|
| 状态：使用中 |
| 此标签的工具 |
用作注释，类似于 description=* 或 note=*。