Uk:Automated Edits code of conduct

From OpenStreetMap Wiki
Jump to navigation Jump to search

Всі мають дотримуватись Кодексу проведення автоматизованих редагувань під час виконання Автоматизованих редагувань в базі OpenStreetMap. Ці правила поширюються як на осіб що використовують ботів, так і на сценарії, що використовуються або створюються, для імпорту даних та виконання інших систематичних змін в даних, що не передбачають оцінку впливу кожної такої зміни на стан інших даних. Ці правила також застосовуються до значних змін, що виконуються за принципом 'пошук-заміна' чи подібних дій, що пропонуються програмами редагування даних OpenStreetMap, такими як JOSM.

Мета цих правил – уникнути пошкодження бази даних. Завжди пам’ятайте, що може бути досить важко, чи навіть неможливо повернути назад, чи 'відкотити' недоречні зміни, особливо там де відбулись подальші зміни об’єктів, які були зачеплені автоматизованими змінами, тому недбалі автоматизовані редагування можуть призвести до витрачання значних зусиль інших, щоб мінімізувати шкоду від невдалих дій. Зневажання цими правилами буде розцінюватись як прояв вандалізму та до них будуть вживатись відповідні заходи протидії, прийнятні у таких випадках.

Доповідь про автоматизовані редагування, що містить огляд цього питання, була представлена на SOTM 2016.

Область застосування

Зазвичай, правила розповсюджуються на всі зміни, де такі зміни об’єктів в базі даних були виконані без їх індивідуального перегляду чи перевірки особою, що керує такими змінами. До них відносяться:

  • зміни, виконані за допомогою Ботів, що за визначенням діють автоматично без прямого втручання з боку людей;
  • імпорти даних, включаючи як автоматизовані імпорти, так і імпорти з використанням стандартних програм-редакторів;
  • інші зміни в базі даних, виконані за допомогою сценаріїв;
  • використання функціоналу 'пошук-заміна' в стандартних програмах-редакторах, таких як JOSM, або пошук з використанням сторонніх сервісів, таких як Overpass API, та заміна даних без індивідуального розгляду кожної такої заміни;
  • ручна заміна теґів без їх адекватного аналізу.

Навіть якщо ви збираєтесь систематично змінювати теґи у великої кількості об’єктів і не думаєте, що це автоматичне редагування, яке підпадає під цей кодекс поведінки, все одно добре заздалегідь обговорити свої дії. Можливо, серед місцевої спільноти існує консенсус щодо поточного теґування, про який вам не відомо. Або ви неправильно зрозуміли сторінку у Wiki OpenStreetMap? Обговорення зі спільнотою заздалегідь зменшує ймовірність того, що вам доведеться обговорювати відкат ваших змін.

Настанови

Будьте обережні!

OpenStreetMap побудовано на консенсусі, а не на простій більшості голосів, тож ви маєте дослухатись до спільноти під час виконання важливих змін, навіть тоді, коли більшість не проти. Зауважте також, що документація щодо застосування теґів, викладена у Вікі, не є остаточним арбітром «правильного» тегування.

Запропоновані вами зміни можуть змінити або модифікувати роботу багатьох інших маперів у місцях, з якими ви не знайомі та про культурні особливості яких вам не відомо. Тому важливо, щоб ви ретельно готувались та планували свою роботу та виконували її професійно та обережно.

Якщо хтось оскаржує ваші дії на будь-якому етапі, залишайтесь коректним, дослухайтесь та звичайно утримуйтесь від війни правок. Якщо проблему не вдається розв’язати, зверніться за допомогою до когось за для посередництва.

Прийнятне застосування
  • Виправлення помилок друку, так наприклад заміна hihgway=residential на highway=residential.
  • Виправлення власних помилок. Якщо ви знаєте, що у вас трапляються систематичні помилки, тоді ви можете виправляти їх автоматизовано. Однак майте на увазі що є ризик того, що ваші зміни можуть зачіпати дані поза межами наміченого обсягу.
  • Корисні зміни, виконання яких вручну може бути виснажливим, які пройшли обговорення та схвалені спільнотою
Застосування, що може викликати певні негаразди
  • Використання інструментів для затвердження правил або власне тлумачення правил, коли можуть бути причини, що виправдовують інші тлумачення або коли правила не відповідають загальній практиці. Це дійсно проблематично, коли купка осіб розробляє власні правила теґування і потім користуючись інструментами автоматизації намагається закріпити їх в базі даних без проведення належного обговорення. Пам’ятайте, що Wiki не слід використовувати як визначення єдино правильного способу теґування, і що неприпустимо використовувати цитати з Вікі для обґрунтування змін, що зачіпають великі обсяги даних без відповідних консультацій.
  • Імпорт даних поверх наявних без відповідної інтеграції нового контенту в той що вже є, або без слідування іншим Настановам з Імпорту даних.
Інші підходи

Як альтернативу до автоматизованих редагувань, ви можете розглянути можливість запропонувати відстежувати виявлені вами проблеми за допомогою інструментів контролю якості даних, таких як Keep Right чи osmose. Інструменти контролю якості даних дозволяють переглядати та виправляти підозрілі дані більш предметно спираючись на знання місцевості та докладне ознайомлення з кожним таким випадком.

Документуйте та обговорюйте свої плани

Якщо ви збираєтесь здійснювати автоматизовані редагування, вам потрібно обговорити їх зі спільнотою та задокументувати ваші плани заздалегідь. Зазвичай ви маєте задокументувати запропоноване редагування на англомовній вікі-сторінці з назвою Automated edits/username (де username — це ваш обліковий запис в OSM, який ви будете використовувати для виконання редагувань, подумайте про це зараз, щоб не перейменовувати сторінку пізніше). У вашій документації має бути зазначено:

  • Хто вносить зміни (бажано ваше справжнє імʼя та спосіб звʼязку з вами, в ідеалі — адреса електронної пошти)
  • Ваша мотивація для змін і чому це важливо
  • Докладний опис алгоритму, за яким ви будете вирішувати, які обʼєкти і як змінювати
  • Інформація про будь-яке обговорення чи консультації, які ви провели, з посиланнями на списки розсилки/форуми або сторінки обговорення на Вікі
  • Коли були внесені зміни або як часто вони будуть повторюватися
  • Інформація про те, як "відмовитися" чи припинити такі зміни
  • Затверджені боти повинні мати вікі-сторінку з назвою вашого бота в якості заголовка. Вони також повинні мати однойменний обліковий запис користувача з чіткими посиланнями між обліковим записом користувача і вікі-сторінкою.

Ваші планимають бути додані до Category:Automated edits log та пройти обговорення на Форумі Спільноти чи подібній платформі.

Якщо локальна спільнота особливо активна на якійсь іншій платформі, наприклад, в Slack або групах Signal, радимо подати пропозицію про автоматизоване редагування там для максимального охоплення спільноти. Однак, на форумі спільноти або у цій Вікі має бути постійний запис про обговорення та рішення спільноти.

  • Це або Форум спільноти;
  • або список розсилки talk;
  • або якщо ваше редагування впливає лише на одну країну чи територію, то використовуйте стандартні методи комунікації для території, на яку поширюються зміни —зазвичай це національні списки розсилки або форуми;
  • або якщо ваше редагування стосується лише міста чи невеликого регіону, місцеві списки розсилки, форуми або інші стандартні методи комунікації в регіоні, на який впливають зміни;
  • також якщо ви виконуєте імпорт, ви так само повинні дотримуватися вимог щодо імпорту, зокрема обговорювати свої плани в списку розсилки для imports. Це також стосується питань, повʼязаних з імпортом, який вже було виконано;
  • а такожі якщо ваше редагування зачіпає спеціалізовану тему, наприклад, громадський транспорт, який має власний список розсилки (https://lists.openstreetmap.org/listinfo/talk-transit), то ви також повинні обговорити свої плани в цьому списку розсилки;
  • а також якщо діяльність кваліфікується як організована, то, можливо, також потрібно буде дотримуватися Керівних принципів організованого редагування тощо.

Коли ви з’ясуєте, що ваші плани знайшли схвальний відгук серед спільноти за винятком кількох осіб, що мають іншу точку зору, попрацюйте з цими людьми, щоб зрозуміти причини їхніх заперечень. Якщо ви не можете знайти порозуміння з ними, подумайте про те як зробити виключення щодо їх редагувань або місцевості в якій вони активні. Якщо спротив значно ширший, вам можливо доведеться переглянути ваші плани.

Зауважте, що будь-які подальші зміни чи розширення області застосування щодо ваших початкових пропозицій також мають бути обговорені у той самий спосіб та отримати схвалення спільноти. Неможливо отримати схвалення щодо деяких неконкретних дій на кшталт "Виправлення помилок в теґах".

Виключення

У деяких відносно рідкісних випадках автоматизоване редагування не потребує обговорення, документування та затвердження. До них відносяться:

  • грубі хібодруки, наприклад заміна tunnel=coulvert на tunnel=culvert або cuisine=African на cuisine=african[1]
  • відкати вандальних дій
  • виправлення власної роботи — в такому випадку ви повинні бути на 100% впевнені, що змінюєте тільки те, що було змінено вами
  • відкат автоматизованих редагувань, які потребували обговорення та дискусії

Зверніть увагу, що "Я вважаю, що ця схема теґування дурна і повинна бути змінена" не вважається за виправлення хибодруків. Наприклад заміна surface=chipseal на surface=asphalt не вважається виправленням хибодруку, і може бути поганою ідеєю з самого початку. Заміна surface=paving_stones:30 на surface=paving_stones + paving_stones:shape=square + paving_stones:length=0.3 також не є чимось, що можна назвати виправленням хибодруку. Виправлення подібних випадків вимагає попереднього обговорення.

Зверніть увагу, що деякі, здавалося б, помилки можуть бути більш складними: building=houseq може бути скоріш за все результатом того, що хтось намагався в редактрі iD спрями ти кути будівлі за допомоги гарячої клавіші Q. У такому випадку кути будівлі, ймовірно, слід всеж таки випроямити та перевірити і виправити теґи, а не просто виправити теґи, як раніше.

Якщо у вас є якісь сумніви, особливо якщо ви помилялися в таких речах раніше: запитайте, перш ніж запускати масову заміну.

Дійте уважно

Ви маєте:

  • Виконувати лише невеличкі зміни за допомогою нового боту перед отриманням схвалення та відгуків, перш ніж розпочати масові виправлення.
  • Переконатись, що ви оновлюєте дані лише на основі актуального стану даних. Ви маєте бути впевненні, що ви ніколи випадково не перезапишете щось, що хтось інший тільки що змінив, використовуючи раніший дамп планети.
  • Бути впевненні, що у вас в наявності всі дані на випадок, якщо вам доведеться скасовувати ваші редагування, коли щось піде не так.
  • Планувати вміст ваших наборів змін розсудливо. Якщо ваш бот створює один набір змін для кожного редагування, їх стає важко читати людям. Якщо ваш бот створює один набір змін для цілого ряду виправлень, що охоплюють всю планету, його теж важко читати. Зміни, які згуртовані по невеликих регіонах легше піддаються аналізу іншими маперами (наприклад: "Виправлення теґів highway в Зачепилівському районі").
  • Переконатись, що існує чіткий спосіб визначення змін, виконаних за допомогою вашого бота чи сценарію. Ви можете створити окремий обліковий запис для цього, або використовувати теґи до наборів змін накшталт "source", "created_by", чи "note".
  • Додавати теґ "comment" до ваших наборів змін із зрозумілим для інших поясненням. Також ви маєте додавати теґи mechanical=yes (чи bot=yes), крім того ви маєте посилатись на сторінку документації Вікі для ваших змін за допомогою теґа description=* (напр. description=https://wiki.openstreetmap.org/wiki/Mechanical Edits/Hupalo Vasyl#Tag Fixup January 2013)
  • Поважайте запити про припинення, тобто якщо хтось звʼязується з вами і просить припинити автоматичне редагування вже відредагованих обʼєктів, ви повинні виконати це побажання і модифікувати своє програмне забезпечення або процедуру так, щоб у майбутньому ці обʼєкти залишалися недоторканими.

Розв’язання конфліктів

Завжди є ймовірність, що хтось буде незадоволений такими змінами, навіть після довоготривалих обговорень. Тож будьте готові до цього та розглядайте всі скарги від інших маперів ретельно та будьте вічливими. Якщо ви дотримуєтесь цих правил, це означає, що ваш обліковий запис не буде заблокований негайно, якщо хтось поскаржиться, але вам все одно доведеться змінити або припинити те, що ви робите, якщо іншим не подобаються ваші та / або побічний ефект від ваших дій.

Можливо, що ваші зміни будуть скасовані, навіть якщо ви дотримуєтесь цих правил; вони не гарантують, що ваші зміни будуть прийняті. Data Working Group розслідуватимите та реагувати на проблеми, що не можуть бути розв’язані відповідно до вищенаведеного, та може або заблокувати обліковий запис негайно або надіслати попередження (в залежності від активності облікового запису). Всі автоматизовані редагування, що не дотримуються правил мають бути якнайшвидше скасовані після їх виявлення. У випадках, коли зміни, які порушують ці правила, настільки тісно змішуються з "нормальними" змінами, що їх важко розрізнити, можливо, скасування проблемних змін також спричинить певну побічну втрату серед "звичайних" редагувань.

Дивіться також

Посилання