JA:Automated Edits code of conduct

慎重にしてください!

OpenStreetMap は多数決ではなく合意形成により作られており、たとえ大多数の人が賛成していても、大がかりな変更をする前には慎重な配慮が欠かせません。それに合わせて ウィキ にあるタグ付け関連の解説文書は、'正確な' タグ付けの根拠とはならない点も留意が必要です。

ときとして、自分はあまり詳しくない場所を編集する行為は、それまで多くのマッパーがつぎこんだ作業を変更したり改変することになり、また文化的背景を理解しない行為にさえなります。そこでとことんリサーチをして何をどう編集するかきちんと見通しを立てること、責任ある態度で慎重に実行することが重要なのです。

編集のどの段階でも、異論をぶつけられたときにはあくまでも礼儀正しく、相手の声を傾聴し、確実に編集合戦 紛争 (編集合戦) を回避します。もし膠着状態になったら、だれかに相談し仲裁をしてもらいます。

受容される利用法

• 明らかな誤字の修正の例を示すなら hihgway=residential (誤) から highway=residential (正) への変更。
• 自分自身の作業の訂正。あるパターンで間違えたと気づいたら、そのパターンの箇所を訂正するのに自動編集の手順を使うことは認められています。しかしながら自分の想定外のデータまで改変するかもしれない可能性は意識してください。

問題のある利用法

• 特定の方針を断固として認めさせるため、もしくは方針の個人的な解釈を押し通そうとして特定のツールを使用するのではなく、他の解釈もなりたつ正当な可能性、あるいは方針が慣例に合わない可能性も意識しなければなりません。特定の個人もしくは小グループがコード付与の方針を書き、コミュニティとの合意のないまま自動化されたプロセスでデータベースを改変した場合などは非常にやっかいです。私たちのウィキとは、論理的に正しいタグ付けを証明するために利用するべきではないこと、適切な合意形成を行わず、ウィキを正当化の典拠に使って、データベースに広範な改変を加えてはいけません。
• すでに存在するデータ、あるいはまたインポートのガイドラインその他に依拠したデータに対して、一律に上書きしてはいけません。変更箇所は個別のデータの、既存の記述に統合させます。

その他のアプローチ

自動編集の代替策として、問題点を Keep Right (キープライト) などの品質保証ツールに送ります。すると問題のあるデータかどうか、地域の知識に詳しい人が時間のあるときに査読して、慎重に妥当性を検討してくれるはずです。

計画を文書化し、話し合う

内容はどうであれ自動編集をしようと決めたら、協議の準備として事前に文書を用意する必要があります。その文書を当該のウィキに保持したら、変更案は適切な mailing list (複数メーリングリスト可) に提案して協議へ進むという手順です:

以下のいずれかのメーリングリストを選びます。

• talk (一般的な提案向け)
• または新規もしくは過去のインポートについては imports。
• または特定の国もしくは地域1ヵ所だけに影響する場合は、対象地域の言語のメーリングリストかフォーラムまたは他の標準的な話し合いの方法。
• あるいはまた変更が都市など限定的な地域だけに影響する場合は、対象地域の言語のローカルのメーリングリストかフォーラムか他の標準的な話し合いの方法。
• そしてさらに特定のサブジェクトすなわち石油井戸や公共交通のように専用のリストが存在する場合は、変更案をそちらのメーリングリストにおいても協議する必要があります。

計画案が数名の反対を除き広く賛同されたなら、反対者と協力して反対理由を理解する努力をします。それらを取り入れることができない場合、その人たちの編集、あるいはそのエリアを対象外にできないか考慮します。もし反対の声が多い場合は、むしろ計画案の見直しに進むほうが妥当です。

留意点として、変更計画の範囲を後日、修正したり拡張する点についても、同様の手順で協議に含めるものとし、別個、コミュニティの承認を受けなければなりません。「タグの誤字を修正する計画です」などのような曖昧なものは一括認可を得られません。

通常は編集計画案を英語版のウィキページ「Automated edits/username」に掲載 (username 部分は計画中の変更を実行するときに使う予定の OSM アカウントの利用者名を代入 - 今ここで どれを使うか決めておき、あとでページの改名の手間を省略) し、分類はCategory:Automated edits log とします。 (訳注：文書の最下部にリンクを記入)

ここで言う文書には以下の各項目が必須です。

• 変更の実施者 (実名とその連絡先が望ましく理想はメールアドレス)
• その変更をする動機と、なぜそれが重要か
• どのアルゴリズムを使い、どの変更対象を選んでどう変更するか内容の詳細説明
• これまでにどのような相談を済ませたか述べ、メーリングリストやフォーラムの投稿へのリンク、もしくはウィキの議論ページへのリンク
• 変更の実施時期、もしくは繰り返し作業の頻度、
• 「選択しない」オプトアウトの方法の説明
• 承認済みのボットには、あなたが使うボット名を付けたウィキページを用意する必要があります。またその同名の利用者アカウントを作り、ウィキページと明示的にリンクさせます。

慎重に実行する

You should:

• Execute only a small number of edits with a new bot before requesting and waiting for feedback before proceeding with larger edits.
• Ensure that you only update based on the current dataset. Ensure that you will never accidentally overwriting something that has been just modified by someone else by using a earlier planet file.
• Ensure that you keep all data you need in case you have to revert your change when something goes awry.
• Plan your changesets sensibly. If your bot creates one changeset for each edit, that becomes extremely hard to read for people. If your bot creates one changeset for a bunch of changes covering the whole planet, that, too, becomes hard to read. Changes grouped into small regions are easiest to digest for human mappers (e.g. "fixed highway tags in Orange County").
• Make sure that there is some way of identifying that a certain change has been made by your script. You could create a special user account for the script, or you could add a "source", created_by", or "note" tag or something.
• A "comment" tag to the changeset that describes the changes made in this changeset in a human-readable way. You must also add the tag mechanical=yes (or bot=yes), and you must link to the wiki page or user page documenting your changes from the description=* tag (e.g. description=https://wiki.openstreetmap.org/wiki/Mechanical Edits/John Doe#Tag Fixup January 2013).
• Provide a means for mappers to "opt out" of your changes, i.e. if someone contacts you and asks you to stop making automated edits to things that they have edited, you must comply with that wish, and you must modify your software or procedure to leave those objects untouched in the future.
• For major changes (in the six-digit range or more), check with the admins (try IRC) to ensure that there your change will not interfere with any other operations at a sys admin level, or check the Munin graphs to find out at which time the servers are not busy.