Id:Automated Edits code of conduct

From OpenStreetMap Wiki
Jump to navigation Jump to search

Kode etik Suntingan Otomatis harus dipatuhi setiap saat ketika melakukan suntingan otomatis ke dalam database OpenStreetMap. Aturan ini berlaku bagi siapa saja yang menggunakan bot, skrip yang digunakan atau dibuat untuk mengimpor data baru, maupun untuk melakukan perubahan sistematis lainnya ke dalam database melalui cara lain tanpa mempertimbangkan setiap perubahan satu per satu. Kebijakan ini juga berlaku untuk perubahan substansial yang dilakukan menggunakan fungsi 'cari dan ganti' (find and replace) atau fungsi serupa dalam editor standar seperti JOSM.

Tujuan dari kebijakan ini adalah untuk menghindari kerusakan pada database. Perlu disadari bahwa membatalkan atau mengembalikan (roll back) suntingan yang tidak tepat bisa jadi sangat sulit atau bahkan mustahil, terutama jika sudah ada suntingan lanjutan pada objek yang terdampak. Suntingan otomatis yang ceroboh dapat menimbulkan beban kerja yang besar bagi pihak lain untuk memperbaiki kerusakan tersebut. Mengabaikan kebijakan ini akan dianggap sebagai vandalisme dan akan ditindaklanjuti sebagaimana mestinya jika terus berlanjut.

Sebuah presentasi tentang suntingan mekanis pernah disampaikan pada SOTM 2016, yang memberikan gambaran berguna mengenai isu-isu terkait.

Cakupan

Secara umum, kebijakan ini mencakup semua suntingan di mana perubahan dilakukan terhadap objek dalam database tanpa ditinjau satu per satu oleh orang yang mengendalikan suntingan tersebut. Ini termasuk:

  • Perubahan yang dilakukan oleh Bot, yang menurut definisinya bekerja secara otonom tanpa intervensi manusia.
  • Impor data, termasuk impor yang sepenuhnya otomatis maupun yang menggunakan editor standar.
  • Perubahan berbasis skrip lainnya yang dilakukan pada database.
  • Penggunaan fungsi cari-dan-ganti (find-and-replace) menggunakan editor standar seperti JOSM, atau pencarian menggunakan layanan seperti Overpass API dan mengubahnya tanpa meninjau setiap objek secara individual.
  • Mengubah tag secara manual dalam jumlah besar tanpa peninjauan yang memadai.

Meskipun Anda berniat mengubah pelabelan (tagging) pada sejumlah besar objek secara sistematis dan merasa bahwa itu bukan termasuk suntingan otomatis yang diatur dalam kode etik ini, sangat disarankan untuk mendiskusikan rencana Anda terlebih dahulu. Mungkin ada konsensus di komunitas lokal mengenai pelabelan saat ini yang tidak Anda ketahui, atau mungkin Anda salah memahami halaman di Wiki OpenStreetMap. Berdiskusi di awal akan mengurangi kemungkinan terjadinya perselisihan atau pembatalan suntingan Anda.

Panduan

Berhati-hatilah!

OpenStreetMap dibangun di atas konsensus, bukan pemungutan suara mayoritas. Oleh karena itu, Anda harus peka dalam melanjutkan perubahan besar meskipun sebagian besar orang mendukung perubahan tersebut. Perlu dicatat juga bahwa dokumentasi pelabelan di Wiki bukanlah penentu mutlak dari pelabelan yang 'benar'.

Suntingan yang Anda usulkan mungkin mengubah atau memodifikasi hasil kerja banyak pemeta lain di tempat-tempat yang tidak Anda kenal, bahkan dalam budaya yang tidak Anda ketahui. Oleh karena itu, sangat penting bagi Anda untuk meneliti dan merencanakan pekerjaan Anda dengan rajin serta melaksanakannya dengan hati-hati secara profesional.

Jika ditegur pada tahap apa pun dalam proses ini, tetaplah bersikap sopan, dengarkan, dan hindari perang suntingan. Jika masalah tidak dapat diselesaikan, mintalah bantuan pihak ketiga untuk menengahi.

Penggunaan yang dapat diterima
  • Memperbaiki kesalahan ketik (typo) yang jelas, misalnya mengubah hihgway=residential menjadi highway=residential.
  • Memperbaiki pekerjaan Anda sendiri. Jika Anda menyadari telah melakukan kesalahan sistematis, Anda boleh memperbaikinya secara sistematis menggunakan proses otomatis. Namun, waspadai risiko bahwa proses Anda mungkin mengubah data di luar cakupan yang dimaksudkan. Memperbaiki pekerjaan orang lain atas permintaan langsung dari yang bersangkutan juga diperbolehkan.
  • Suntingan bermanfaat yang akan sangat membosankan jika dilakukan secara manual, dilakukan hanya setelah mendapat persetujuan komunitas dan diskusi yang tepat.
Penggunaan yang bermasalah
  • Menggunakan alat untuk memaksakan suatu kebijakan, atau interpretasi pribadi Anda terhadap kebijakan, padahal mungkin ada alasan yang dapat dibenarkan untuk interpretasi lain atau di mana kebijakan tersebut tidak mencerminkan praktik umum di lapangan. Masalah utama muncul ketika seseorang atau kelompok kecil membuat kebijakan pengkodean lalu menggunakan proses otomatis untuk memaksakannya ke dalam database tanpa konsultasi yang memadai. Sadarilah bahwa Wiki tidak boleh digunakan sebagai satu-satunya definisi cara pelabelan yang benar, dan tidak diperbolehkan menggunakan Wiki sebagai pembenaran untuk perubahan data secara luas tanpa konsultasi yang tepat.
  • Mengimpor data di atas data lain tanpa mengintegrasikan konten baru secara benar dengan data yang sudah ada, atau tidak mematuhi Panduan Impor.
Pendekatan lain

Sebagai alternatif suntingan otomatis, pertimbangkan untuk mengirimkan usulan masalah ke alat penjaminan kualitas seperti Keep Right atau osmose. Di sana, data yang bermasalah dapat ditawarkan untuk ditinjau oleh seseorang yang memiliki waktu dan pengetahuan lokal untuk mempertimbangkan perubahan tersebut dengan lebih saksama.

Dokumentasikan dan diskusikan rencana Anda

Jika Anda berencana melakukan suntingan otomatis apa pun, Anda harus mendokumentasikan dan mendiskusikan rencana tersebut sebelumnya. Biasanya, Anda harus mendokumentasikan usulan suntingan Anda pada halaman wiki berbahasa Inggris bernama Automated edits/username (di mana username adalah nama pengguna OSM dari akun yang akan Anda gunakan untuk melakukan suntingan). Dokumentasi Anda harus menyatakan:

  • Siapa yang melakukan perubahan (sebaiknya nama asli Anda dan cara menghubungi Anda, idealnya alamat email).
  • Motivasi Anda melakukan perubahan dan mengapa hal itu penting.
  • Deskripsi mendalam tentang algoritma yang akan Anda gunakan untuk memutuskan objek mana yang akan diubah dan bagaimana perubahannya.
  • Informasi tentang konsultasi yang telah Anda lakukan, dengan tautan ke postingan milis/forum atau halaman diskusi Wiki.
  • Kapan perubahan dilakukan, atau seberapa sering perubahan tersebut akan diulang.
  • Informasi tentang cara untuk "opt out" (menolak keterlibatan).
  • Bot yang telah disetujui harus memiliki halaman wiki dengan nama bot tersebut sebagai judulnya. Bot juga harus memiliki akun pengguna dengan nama yang sama dengan tautan yang jelas antara akun pengguna dan halaman wiki tersebut.

Rencana Anda harus ditambahkan ke Category:Automated edits log dan kemudian didiskusikan di platform yang dikelola oleh OSM(F) seperti...

  • Antara Forum Komunitas OpenStreetMap (Community Forums);
  • Atau talk (milis serbaguna);
  • Atau jika suntingan Anda hanya berdampak pada satu negara atau wilayah, gunakan metode komunikasi standar untuk wilayah tersebut — biasanya milis bahasa nasional atau forum lokal (untuk Indonesia, bisa melalui forum komunitas Indonesia);
  • Atau jika suntingan Anda hanya berdampak pada kota atau wilayah kecil, gunakan milis lokal, forum, atau metode komunikasi standar lainnya di area tersebut;
  • Dan jika Anda melakukan impor, Anda juga harus mengikuti persyaratan Import/Guidelines, termasuk mendiskusikan rencana Anda di Forum Komunitas. Ini juga berlaku untuk masalah pada impor sebelumnya;
  • Dan jika suntingan Anda berdampak pada subjek spesialis, seperti transportasi umum yang memiliki milis sendiri (https://lists.openstreetmap.org/listinfo/talk-transit), maka Anda juga harus mendiskusikan rencana Anda di milis tersebut;
  • Dan jika kegiatan tersebut tergolong sebagai penyuntingan terorganisir, mungkin juga perlu mengikuti Organised Editing Guidelines.

Jika komunitas lokal sangat aktif di platform lain, misalnya saluran Telegram, grup Slack, Facebook, atau Signal, kami menyarankan untuk menyampaikan usulan suntingan otomatis Anda di sana demi visibilitas komunitas yang maksimal. Namun, tetap harus ada catatan permanen mengenai diskusi dan keputusan komunitas di Community forum atau Wiki ini, karena kita tidak memiliki kendali atas berapa lama platform tersebut akan ada atau berapa lama mereka menyimpan informasi.

Jika Anda menemukan bahwa rencana Anda diterima secara luas kecuali oleh beberapa orang yang keberatan, ajaklah mereka berdiskusi untuk memahami alasan keberatan mereka. Jika tidak ditemukan kesepakatan, pertimbangkan untuk mengecualikan suntingan atau area mereka. Jika ada penolakan yang lebih luas, Anda sebaiknya mempertimbangkan kembali rencana Anda.

Perhatikan bahwa setiap modifikasi atau perluasan cakupan perubahan di kemudian hari juga harus didiskusikan dengan cara yang sama dan memerlukan persetujuan komunitas yang baru. Tidak diperbolehkan mendapatkan persetujuan umum untuk hal yang tidak spesifik seperti "Saya sedang memperbaiki tag yang salah eja".

Pengecualian

Dalam beberapa kasus yang relatif jarang, suntingan otomatis tidak memerlukan diskusi, dokumentasi, dan persetujuan. Ini termasuk:

  • Kesalahan ketik (typo) yang sangat jelas, seperti mengubah tunnel=coulvert menjadi tunnel=culvert atau cuisine=African menjadi cuisine=african.
  • Membatalkan vandalisme (reverting vandalism).
  • Memperbaiki pekerjaan Anda sendiri — dalam hal ini Anda harus yakin 100% bahwa Anda hanya mengubah apa yang Anda sunting sebelumnya.
  • Membatalkan suntingan otomatis yang seharusnya memerlukan diskusi namun diskusi tersebut tidak dilakukan.

Perlu dicatat bahwa "Menurut saya skema pelabelan ini konyol dan harus diubah" tidak dianggap sebagai kesalahan ketik. Sebagai contoh, mengubah surface=chipseal menjadi surface=asphalt tidak dianggap sebagai "memperbaiki typo" — dan mungkin merupakan ide yang buruk sejak awal. Mengubah surface=paving_stones:30 menjadi surface=paving_stones + paving_stones:shape=square + paving_stones:length=0.3 bukanlah memperbaiki typo. Melakukan hal seperti itu memerlukan diskusi.

Perhatikan bahwa beberapa hal yang tampak seperti typo mungkin lebih kompleks — misalnya building=houseq kemungkinan besar adalah hasil dari seseorang yang mencoba merapikan kotak (squaring) bangunan di iD menggunakan pintasan q, dalam hal ini bangunan tersebut seharusnya dirapikan geometrinya dan dilabeli ulang, bukan sekadar diganti tag-nya.

Jika Anda ragu sama sekali, terutama jika Anda pernah salah mengenai hal tersebut sebelumnya: tanyalah sebelum menjalankan penggantian massal.

Laksanakan dengan hati-hati

Anda harus:

  • Menjalankan hanya sejumlah kecil suntingan dengan bot baru di awal sebelum melanjutkan dengan suntingan yang lebih besar.
  • Memastikan bahwa Anda hanya memperbarui berdasarkan kumpulan data (dataset) terbaru. Pastikan Anda tidak akan pernah secara tidak sengaja menimpa sesuatu yang baru saja diubah oleh orang lain karena menggunakan file planet yang lama.
  • Memastikan Anda menyimpan semua data yang diperlukan jika Anda harus membatalkan perubahan apabila terjadi kesalahan.
  • Merencanakan changeset Anda dengan bijak. Jika bot Anda membuat satu changeset untuk setiap satu suntingan, itu akan sangat sulit dibaca oleh orang lain. Praktik seperti itu juga akan dianggap sebagai mengakali sistem jika dilakukan oleh manusia. Jika bot Anda membuat satu changeset untuk kumpulan suntingan yang mencakup seluruh planet, itu juga sulit dibaca dan mengotori riwayat di tempat-tempat yang jauh dari lokasi perubahan. Suntingan yang dikelompokkan ke dalam wilayah kecil adalah yang paling mudah dipahami oleh pemeta manusia (misal: "perbaikan tag jalan di Jakarta Selatan").
  • Memastikan ada cara untuk mengidentifikasi bahwa perubahan tertentu dilakukan oleh skrip Anda. Anda bisa membuat akun pengguna khusus untuk skrip tersebut, atau menambahkan tag "source", "created_by", atau "note".
  • Menambahkan tag "comment" pada changeset yang menjelaskan perubahan yang dilakukan secara manusiawi (dapat dibaca manusia). Anda juga harus menambahkan tag mechanical=yes (atau bot=yes). Anda harus menyertakan tautan ke halaman wiki atau halaman pengguna yang mendokumentasikan perubahan Anda pada changeset, misalnya menggunakan tag description=* (contoh: description=https://wiki.openstreetmap.org/wiki/Mechanical Edits/NamaPengguna#PerbaikanTagJanuari2024).
  • Menghormati permintaan "opt out", yaitu jika seseorang menghubungi Anda dan meminta Anda berhenti melakukan suntingan otomatis pada hal-hal yang telah mereka sunting, Anda harus mematuhi keinginan tersebut dan memodifikasi perangkat lunak atau prosedur Anda untuk membiarkan objek-objek tersebut tidak tersentuh di masa mendatang.

Penyelesaian sengketa

Selalu ada kemungkinan orang tidak senang dengan suntingan tersebut, bahkan setelah diskusi ekstensif. Jadi bersiaplah untuk ini, dan tangani semua keluhan pengguna secara serius dan sopan. Jika Anda telah mengikuti kebijakan ini, akun Anda tidak akan langsung diblokir saat seseorang mengeluh, tetapi Anda mungkin tetap harus mengubah atau menghentikan apa yang Anda lakukan jika orang-orang tidak menyukai tindakan Anda dan/atau efek sampingnya.

Suntingan Anda mungkin dibatalkan (revert) meskipun Anda telah mengikuti kebijakan ini; ini tidak menjamin suntingan Anda akan diterima. Data Working Group akan menyelidiki dan bertindak atas masalah yang tidak dapat diselesaikan melalui langkah-langkah di atas dan dapat memblokir akun segera atau mengirimkan pesan peringatan (tergantung pada seberapa intens aktivitas penyuntingan tersebut). Semua suntingan otomatis yang tidak mengikuti kebijakan ini berisiko untuk segera dibatalkan ketika ditemukan. Dalam kasus di mana suntingan yang melanggar kebijakan ini tercampur sangat rapat dengan suntingan "normal" sehingga sulit dibedakan, ada kemungkinan bahwa pembatalan suntingan bermasalah tersebut juga akan menyebabkan beberapa kerusakan kolateral pada suntingan "normal".

Lihat juga

Referensi