Re: A plea for meaningful changeset comments

Communities Россия (Russia)
1

В @talk недавно прошло обсуждение бессмысленных комментариев к changeset-ам, и я хотел бы обратить внимание и русского сообщества на эту проблему.

Возьмём, для примера, Петербург за последнюю неделю:

tmprec     правки
Batareikin     Sibirskaya addr
Zverik     поправил название, удалил дубликат дороги
Zverik     _link не должны иметь названий, в общем-то. Также, поправил точки
Zverik     правильный выход со ст. м. Спортивная
Dinamik     Saint Petersburg
Dinamik     Saint Petersburg
one_half_3544     дорожки в парке победы
Batareikin     Antonovskaya addr
ZCC     Гражданский проспект
tmprec     правки
tmprec     мелкие правки
Batareikin     Chichurinsky addr
nettroll     Дворовый проезд, банкомат
polet82     (нет)
polet82     (нет)
polet82     Подземный переход на Савушкина
tmprec     правки
polet82     (нет)
Shuric     ***
Shuric     ***
Shuric     ***
SteelRat     (нет)
SoNiKa     (нет)
SoNiKa     (нет)
Shuric     ***
SoNiKa     (нет)
Shuric     ***
Shuric     ***
tmprec     Здания
polet82     (нет)
polet82     (нет)
polet82     (нет)
tmprec     правки
KonTur     Вознесенский
KonTur     Декабристов-Грибоедова
KonTur     номера домов Бассейная-Космонавтов-Витебский
KonTur     мелкие правки
XroM     Добавил несколько дворовых проездов
tmprec     A120 set primary
tmprec     Здания
Sergey Astakhov     СПб. Мурманское шоссе. Коррекция дорог по GPS-трекам
Sergey Astakhov     СПб. Мега-Дыбенко. Коррекция тегов
pelentron     проверил дом по треку.
Sergey Astakhov     СПб. Мега-Дыбенко. Коррекция дорог по GPS-трекам
Sergey Astakhov     СПб. Коррекция дворовых проездов
Alexander Leschinsky     Удалены из атрибутов трамвайные пути которые недавно были демонтированы
lupin-de-mid     fix road status
lupin-de-mid     rename scool
Ivan Komarov     (нет)
tmprec     объекты инфраструктуры
tmprec     Здания
nettroll     Добавлен дворовый тупик
Zverik     забыл разбить пару домов по Шевченко
Zverik     наконец-то добил последний две страницы давней прогулки около ул. Шевченко
one_half_3544     дорожки в парке победы
tmprec     правки
Batareikin     Tarasova addr
tmprec     Здания
Batareikin     Rybatskiy addr
tmprec     правки
Batareikin     Shepetovskaya addr
StirliZ     BBOX:30.22,59.94,30.24,59.95 ADD:2 UPD:10 DEL:0
StirliZ     BBOX:30.23,59.94,30.24,59.95 ADD:5 UPD:2 DEL:0
Javits     Adding new house on Kommuna street of Saint-Petersburg, Russia
StirliZ     BBOX:30.23,59.95,30.23,59.95 ADD:3 UPD:0 DEL:0
one_half_3544     дорожки в парке победы
polet82     (нет)
polet82     (нет)
polet82     (нет)
Sergey Astakhov     СПб. Коррекция железных дорог, удаление дубликатов остановок
Sergey Astakhov     СПб. Коррекция дворовых проездов
tmprec     правки
polet82     (нет)
polet82     (нет)
polet82     (нет)
polet82     new footway in Saint-Petersburg, Russia
Batareikin     Aprelskaya addr
Batareikin     Burenina addr
Batareikin     Vyborgskaya Storona road name
Batareikin     Petra Smorodina addr
Batareikin     Peredivikov addr
polet82     (нет)
lupin-de-mid     понизил статус улиц
polet82     (нет)
Shuric     ***
Shuric     ***
Paul Shmarev     правка
Shuric     ***
tmprec     пои
tmprec     роутинг
Soitanen     поворот с фурштатской
Paul Shmarev     правка
Paul Shmarev     правка
Sergey Astakhov     СПб. Здание не может быть дорогой.
tmprec     Здания

И того, примерно половина комментариев — либо ничего, либо слова, эквивалентные «ничего». Можно ли сказать, что изменилось на карте Петербурга за неделю? Не особо. Почему, потратив полчаса на редактирование, вы не хотите потратить полминуты на описание правок?

Заодно хочу сказать спасибо пользователям Sergey Astakhov, Alexander Leschinsky, KonTur, lupin-de-mid, one_half_3544, Batareikin и прочим, чьи описания избавляют от необходимости открывать changeset и заглядывать в историю изменений узлов и линий.

2

НА самом деле трудно описать изменения, если их много и мелких. Я когда треки по городу обрабатываю, там дорисую кусочек, там поправлю, там тег впишу - в комментариии указываю “мелкие изменения по городу”, я и сам не помню до деталей, что и где изменил.

Проще, конечно, когда целый квартал домов по кадастру рисуешь, или допустим дороги в определенном районе.

3 
StirliZ     BBOX:30.22,59.94,30.24,59.95 ADD:2 UPD:10 DEL:0

меркаакртор автоматом подставляет, я по началу не в курсе был что это такое, затем менял, но когда в обновлениях 3-4 точки меняешь , дольше получается коментарии придумывать.

4

это всё «долго» и «слишком много» — от отсутствия привычки. Ну и такой ленью вы тратите куда больше времени тех, кто решил посмотреть на историю изменений в районе. Длина поля практически неограничена, можно хоть эссе написать. Хотя почти всегда можно обойтись одним-двумя предложениями, вида «поправил названия магазинов на Васильевском острове, подвигал улицы по Yahoo, нарисовал кварталы между первой и третьей линиями».

5

Тогда комментарий к changeset станет примерно таким :slight_smile:

-Добавил пару световоров, тройку пешеходных, поправил улицу, удалил лишние ноды, нарисовал пару недостающих зданий, выровнял здания, добавил недостающий знак запрета, отрисовал пару газонов.

Недоверяете пользователям и хотите отчета от них про их правки?

6

да причём здесь доверие? Я хочу посмотреть на страницу истории правок и сразу понять, что где изменилось.
нелюбовь к отчётам, вроде, должна была остаться в девяностых годах.

(хотя в некоторых вещах я не доверяю пользователям, но к комментариям это не относится. Откуда, например, Batareikin и KonTur берут номера домов?)

хороший пример комментария, кстати.

7

Большие изменения можно разбивать не несколько маленьких changeset-ов, тогда и комментарии будет проще писать

8

http://rgis.spb.ru/map/ :slight_smile:

9

KonTur, Batareikin — отлично, спасибо :slight_smile:

10

Оттуда же http://rgis.spb.ru/map/

И улиц тоже.