JA:変更セットの良いコメント

From OpenStreetMap Wiki
(Redirected from JA:Good changeset comments)
Jump to navigation Jump to search
  • Good changeset comments
  • In other languages

変更セットは、1人のユーザーが比較的短時間に行った編集作業の区切りです。変更セットをアップロードする時、あなたが使用しているエディタで編集内容を説明する変更セットのコメントを入力する場面があります。

あなたが入力したコメントは、変更セットのタグ（comment=*）としてデータベースに保存されます。これは様々な場面、例えば、誰かがオブジェクトの履歴を閲覧したり、ある範囲におけるすべての変更を表示したりする場合に、編集内容と一緒に表示されます。


変更セットにコメントを入力する理由は？

変更セットに対してコメントを入れておく理由は数多く存在します。

  • 今後その地域を編集するマッパーへの礼節 - 変更セットにコメントがあることで、あなたがどのような目的でどのような編集を行ったのかが、後々のマッパーたちにとって理解しやすくなります。変更セットにコメントがない、ということで、人によってはなんとなく "この地域で僕がどんな編集をしようが、あなたには関係ないことだ"という印象を感じることがあります。そして、1つの要素をみんなで編集する私たちのOSMプロジェクトにおいて、そのようなことはなるべく避けたほうがよいでしょう。
  • 編集の失敗や間違いを防ぐため - もしレストランのノードが50個も削除されていて、編集セットに "Bingをもとに建物を2−3つ追加 (traced a couple houses from Bing)"と記載されているとしたら、その編集はなんらかの間違いの可能性が高く、内容の復旧作業を素早く行うことができるようになります。逆に、変更セットに "先週の現地調査で判明した、既に閉店しているレストランについての情報を削除 (removing restaurants which I found to have closed during last week's survey")"と書いてあれば、あなたが正当な理由をもとに情報の削除を行ったことがわかりやすくなります。
  • あなたが行う編集の価値を高め、編集合戦を防ぐため - あなたが行った編集とその参照先・情報源を示しましょう。例えば、後で誰かが航空写真をもとに建物データを追加しようとしたとして、あなたが追加したデータが航空写真で見当たらない場合にその建物を削除しようとするかもしれません。しかし、もし編集セットに "つい最近建築された建物を追加" と書いてあれば、本当に削除を行なって良いデータかどうかもう一度確認してくれるはずです。
  • 備忘録として。変更セットのコメントは、あなたがいつ何をなぜ行っていたか思い出すのに役立ちます。コメントの情報を読みたくなるのが6ヶ月や1年先かもしれないこと、なぜ古い編集を探す必要があるかをあらかじめ予想するのは難しいことを意識してください。簡単に言えば、犬も食わないものは出すな、ということです。

マッパーによっては、彼らが *行わなかった編集* の内容をメモとして残しておくことがあります。(例えば "...もうちょっと作業が必要" とか "...ただし、河の西側地域は手付かず"といったかんじです)。

場合によっては、変更セットがどのような内容を行ったかの証跡になることもあります。例えば 1つのオブジェクトに対してだけ編集が行われた際、その内容を確認するためには有力な情報ではありますが、これにあてはまるケースは思ったほど多くありません。ただ、誤字を修正した場合に "誤字を修正"と変更セットコメントを残しておくことで、編集内容を明確にしておくことは大切です。もしまた飼い猫がまたキーボードを勝手にいじっても、あなたが本当にやりたかったことが後々わかりやすくなります。


変更セットコメントの使用は必須ですか？

前述のとおり、変更セットコメントを使用することはとてもいい習慣です。特にあなたが長期間マッピングをしている場合や多数のマッピングをしている場合は、使用しないことは無作法とみなされる可能性があります。データワーキンググループは変更セットコメントの使用を強制する権限を持っており、他のコミュニティメンバーが誰かの編集に苦情を申し立てた場合、しばしば使用を強制します。

どんな変更セットコメントを書けばいいですか？

良い変更セットコメントは、編集について簡潔かつ適切に説明するものです。少なくとも動詞（どのように変更したか）と対象（何を変更したか）を含んでいて、さらに編集した場所と使用した情報源を記載することで、よりよいものになります。

コメントは、地図上で編集した内容に絞ってください。次のようなコメントは避けてください:

  • 連絡先（例：メールアドレス）
  • 編集の意図（例：人々を助けるため）

これらの情報は、"https://openstreetmap.org/user/<your_user_name>" のあなたのユーザープロフィールに最も適しています。ユーザー名をクリックすると、あなたの情報、動機、自己紹介が表示されます。

具体例

よい変更セットコメントでは、その編集で意図した内容が簡潔かつ明瞭に記載されています。具体的な例としては以下のとおりです。

  • "工業団地に建物を追加"
  • "樹木を追加"
  • "調査に基づき、 Donnington 通りから Roman Way 通りまでの歩道を追加"
  • "OSAK (AWS)をもとに、デンマーク語の住所表記を修正: Bag Hegnet"
  • "Algonquin 公園の境界を更新"
  • "Newportの南東に、郊外道路と自転車道を追加"
  • "Suffragist 記念碑の区域を追加し、周辺の歩道と駐車場を更新"
  • "Köln: Nicht-Kreisverkehre, 'junction=roundabout' entfernt, Vz 215 nicht vorhanden" (ドイツ語で "ケルン市: junction=roundabout を削除。この位置にラウンドアバウトと、交通標識215番は存在しません")
  • "Maranhãoの海岸線に対して、干潮時の入江をいくつか追加"
  • "Bingと現地調査に基づき、建物と住所を追加。残念ながらいくつかの建物番号は掲示されていなかった."
  • "私道に屋号を追加。Source = Owner"

時には、全く役に立たない内容の変更セットコメントもあります。例えば :

  • "ちょっとした編集"
  • "修正"
  • "マップに追加"
  • "--"
  • "詳細を追加"
  • "更新"
  • "いろいろ改良"
  • "asdf"
  • "アメリカ合衆国"

以下の例は自動生成された可能性があります。何らかの情報を伝えているように見えますが、変更の「内容」と「理由」についての有益な説明はしていません。

  • "BBOX:3.23,41.96,3.23,41.96 追加:14 変更:0 削除:0"
  • "151005-DE-FUe"
  • "2012/01/13 AM09:56:00 ArcGISのOpenSreetMap機能を使って編集をアップロード"

以下の例は、一般的なツールによって自動生成されたものです。より大きなプロジェクトの「内容」と「理由」について他の場所でより情報を見つけられるという点で多少はましですが、レビュアーが外部の情報源を参照せずに理解できるような、特定の編集の説明（人間が書いたものであることが望ましい）に置き換えられるものではありません。

  • "https://maproulette.org/browse/challenges/17994"
  • "#hotosm-project-1234 #MissingMaps #Country #redcross"

このプロジェクトが続く限り、あなたが残した変更セットコメントが残り続けるということを忘れないでください。アプリへの不満を八つ当たりしないよう、あなたが入力したコメントで誰かが不快な思いをしないよう、あなたが利用した情報源に疑問をもつようなことがないような記載を心がけてください。

既存の変更セットに情報を追加する際の注意

変更セットは、変更の数と地理的な範囲の双方において、管理しやすいサイズにするようにしてください。

各エディタのふるまいの違いは以下の通りです。

  • iD はアップロードするごとに新しい変更セットを作成します。 → この節は iD には関係ありません。
  • Potlatch （1および2）は既定では既存の変更セットに追加しますが、［C］を押すと現在の変更セットを閉じることができます。
  • JOSM は既定ではアップロードするごとに新しい変更セットを作成しますが、アップロードダイアログ上の設定で変更することができます。

変更セットをアップロードして変更セットの説明を入力した後、エディタによっては（設定によっては）変更セットをすぐに閉じず、続く編集が同じ変更セットに追加され、変更セットのコメントも共有されることがあります。

1つの編集作業を終えて別の作業を開始する場合は、新しい作業が別の編集セットとして扱われているかどうかを確認してください。

過去に入力したコメントの再利用

ほとんどの編集ソフトでは、過去に利用したコメント文をドロップダウンのリストから選んだり、あらかじめコメント欄に表示されていたりして、再利用することが可能です。この機能は便利なことが多いのですが、あまりに一般的なコメント文(例えば "いくつか編集 (some fixes)"など)をすべての編集作業で使いまわしてしまう、いわゆる "お手軽さの罠 (convenience trap)"に陥ることがあります。これではコメント文の意味がありません。過去のコメント文を再利用する際には、その編集内容とコメントがちゃんと合っているかどうかについても気を配るようにしてください。

JOSM では既定で（4時間以内の場合）最新の変更セットのコメントがあらかじめコメント欄に入力されます。これによって、古い（誤った）コメントが再利用されてしまうことにつながることがあります。この機能は完全に無効にすることができます（方法）。

ハッシュタグ

一部のユーザーが、変更セットのコメントに「ハッシュタグ」を使い始めています。ハッシュタグは「変更セットの良いコメント」に沿っているでしょうか？これは議論の的になっており、広くは合意されていません。にもかかわらず、一部のツールは他のツールが変更セットの分析・可視化に利用するために、定型のハッシュタグ付きのコメントをしています。ハッシュタグは自由な形式のテキスト欄内の、単純なハッシュ（#）の接頭辞が付いた単語です。手入力されたコメントと一緒に利用したり、散在させたりしても良いでしょうが、定型の文しかないものは変更セットの良いコメントではないでしょう。

As part of the OSMF Organised Editing Guidelines, it is suggested to include a unique hashtag in changeset comments, the hashtag should also be clearly stated on the wiki page of the Organised Editing activity. It however unclear if this hashtag should be inserted before or after a human-readable text that actually describes the changeset.

変更セットのいいコメントを使わない人がいたらどうすればいいですか？

マッパーへの連絡

Ask them nicely to do so! You can either write a DM, or leave a comment on a changeset, which arguably is more preferable.

If you're commenting on a changeset by another user, always try and be polite

Hello $username

or if they're a new mapper: 

Hello $username and welcome to OpenStreetMap!

If they have been using short or unhelpful comments such as "." you could add this to your changeset discussion comment:

Please do use meaningful changeset comments - as “.” does not help other mappers understand what you are doing.
See https://wiki.openstreetmap.org/wiki/Good_changeset_comments
Thank you!

If they share the same language as you then obviously write the discussion comment in that language; if they don't - then use an online translator such as Google/DeepL to translate it into their language.

マッパーがこれを無視し続ける場合

You can again politely write to the same changeset asking if the user has seen your message about the need of leaving meaningful comments.

If mapper continues to make changes without meaningful comments while there is no reply to your messages for quite some time - there is an option of sending a report to the OSM moderators through his profile, so that they can look at the situation. Then they can either write about the need to do it themselves, or in some cases put the user in a short block to make them understand that they need to make edits differently.

関連ソフトウェアの作者への連絡

In some cases users of some software systematically make for example edits without changeset comment at all. In such case it is useful to check whether this software does try to stop them.

For example, editor should ask user to fill changeset comment if missing.

In case where editing software is not asking user to fix very common mistakes, it would be useful to open an issue requesting change (if not open already). Maybe also sending patch implementing such feature.

変更セットコメントの検索

日本語版記事における追記

変更セットを記入する際に、英語で入力するべきか日本語で入力するべきか、迷うことがあります。

あくまで私 (user:nyampire)の主観ではありますが、以下のように使い分けています。

  • 英語での記入  : HOT活動や海外での編集など、日本人以外がコメントを参照する可能性がある場合
  • 日本語での記入: それ以外の場合。日本国内の道路やPOIの修正など、今後の編集も日本人、あるいは日本語を読めるマッパーが行う可能性が高い場合

関連項目

Retrieved from "https://wiki.openstreetmap.org/w/index.php?title=JA:変更セットの良いコメント&oldid=2932318"