Голосование по терминологии

liosha · 2009-10-08T04:09:31.000Z

Upliner:

Ну а данные сеанса могут отсутствовать в другом контексте, т.е вне API или при смене API. Скажем, вместо created_at и closed_at будет commited_at. Я это не к тому, что нужно что-то менять, а к тому, что сам термин changeset не настолько привязан к API…

Хорошо, К ЧЕМУ тогда его привязать?
API в этом смысле хорош тем, что он документирован и его документация широко доступна.

А с тем, что в текущей версии API changeset имеет многие свойства сеанса, мы ещё спорим?

Upliner · 2009-10-08T05:20:23.000Z

А с тем, что в текущей версии API changeset имеет многие свойства сеанса, мы ещё спорим?

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

Теги опциональны.

Теги опциональны везде, но сказать, что они не являются свойством, скажем, вея – это сильно. Да, они хранятся в разных табличках, но то, что хранится в таблице ways – это ещё не полноценный way.
Также и здесь я могу сказать, что в текущей модели данных список тегов(пустой или непустой) является неотъемлимой частью changeset-а.

liosha · 2009-10-08T05:46:54.000Z

Я в общем-то не настаиваю, что changeset - это 100%-ный сеанс, просто я не могу подобрать слова ближе по смыслу. Слово “набор” вообще никаких свойств changeset-а не передаёт. Во-первых, набором правок является всё-таки diff changeset-а, а не сам changeset, а во-вторых даже diff - это скорее последовательность, чем набор.

Может, проще будет вообще новое слово придумать?

Ещё одна попытка определения:
Changeset - объект-идентификатор, к которому привязываются вносимые правки (пока без уточнений).

UPD.
Для changeset-а, в отличие от вея, теги (пока?) никаких ключевых свойств не передают.
Только комментарий и клиент.

ikz · 2009-10-08T06:16:07.000Z

liosha:

Может, проще будет вообще новое слово придумать?

Ещё одна попытка определения:
Changeset - объект-идентификатор, к которому привязываются вносимые правки (пока без уточнений).

UPD.
Для changeset-а, в отличие от вея, теги (пока?) никаких ключевых свойств не передают.
Только комментарий и клиент.

Почему бы тогда не сократить до “правка”?
"ПРАВКА — 1. Процесс и сами изменения текста произведения на всех этапах его подготовки к изданию: при переработке и шлифовке рукописи автором (авт. П. оригинала), при совершенствовании авт. оригинала редактором (лит. П., редакционная П.), при корректуре (корректурная П., авт. корректурная П., конъюнктурная изд. П., редакторская корректурная П., техн., или технологическая, корректурная П., типографская корректурная П.).

В полиграфии процесс исправления набора по указаниям изд-ва в корректурных оттисках."

liosha · 2009-10-08T06:22:51.000Z

ikz, правка - это edit, атомарный элемент. см выше

Upliner · 2009-10-08T08:20:27.000Z

Для changeset-а, в отличие от вея, теги (пока?) никаких ключевых свойств не передают.
Только комментарий и клиент.

В модели данных не бывает чего-то “ключевого” и “неключевого”. Она просто описывает как хранить данные. А что мы придумаем с этим делать – это уже другое дело.

liosha · 2009-10-08T08:28:44.000Z

Как раз есть: у объектов есть неотделимые свойства (например, геокоординаты у ноды, список нод у вея или время закрытия у changeset-а), а есть опциональные, которые выносятся в теги.

Upliner · 2009-10-08T08:33:43.000Z

Одно дело “неотделимые”, другое – “ключевые”(кстати, времени закрытия у changeset-а как раз может и не быть). “Опциональные” ещё не значит, что этими свойствами можно пренебречь.

liosha · 2009-10-08T08:39:50.000Z

Так, уже путаница начинается.

Если мы говорим о модели данных, то для неё принципиальна только сама возможность наличия тегов, а свойства, описываемые в тегах, она вообще не рассматривает. А координаты ноды, например, рассматриваются именно в модели данных. И время закрытия changeset-а тоже: поле для него всегда есть, хотя да, оно может быть и не заполнено (пока changeset открыт).

Upliner · 2009-10-08T08:45:02.000Z

Кстати, в trac-е перевели именно как “набор изменений”, в некоторых местах – просто “изменения”. Ну там-то оно и понятно: в svn changeset-ы транзакционны, и diff – неотъемлимая часть changeset-а.
Но понятие оказывается достаточно гибкое и может быть не только транзакционным, но и сессионным, как здесь… Но в то же время само по себе это не транзакция и не сессия…

liosha · 2009-10-08T08:49:35.000Z

Upliner,
с этим определением согласишься?

Ещё одна попытка определения:
Changeset - объект-идентификатор, к которому привязываются вносимые правки (пока без уточнений).

Upliner · 2009-10-08T08:52:01.000Z

liosha:

с этим определением согласишься?

Ну да. Неполное, но в принципе правильное.

liosha · 2009-10-08T09:05:49.000Z

Ок. Дальше

Неотделимые свойства changeset-а:

создавший его пользователь
время создания
время закрытия
область (bbox) правок - рассчитанная или явно заданная
Дополнительные свойства могут быть описаны в тегах.

При этом сам changeset - это неотделимое свойство edit-а.

Как бы это грамотно в определение уместить?

Upliner · 2009-10-08T09:11:17.000Z

Не знаю.
Если бы я где-нибудь видел, чтобы вносимые правки привязывались к сеансам(session), то согласился бы с этим определением. А так – отдаю предпочтение буквальному переводу словосочетания change set.

liosha · 2009-10-08T09:18:05.000Z

Upliner,
пока речь об определении, а не о переводе.

Upliner · 2009-10-08T09:43:55.000Z

Хмм… тогда наверное “запись в журнале”(по аналогии с журналами посещения, журналами платежей и т.д.)

Ilis · 2009-10-08T10:37:38.000Z

Как вариант:

Changeset – объект, логически объединяющий правки и хранящий информацию о времени начала и конца выполнения этих правок, пользователе и клиентской программе, а также необязательном комментарии к этим правкам.

liosha · 2009-10-08T10:53:44.000Z

Клиент точно так же не обязателен, как и комментарий.

Время создания и время закрытия changeset-а слабо связано со временем начала и конца внесения правок.

Сам по себе changeset ничего логически не объединяет - он просто группирует, хотя можно сказать, что он предназначен для логического объединения.

UPD

Ну и опять же это определение учитывает только “послежизние” changeset-а после его закрытия.

Ilis · 2009-10-08T11:17:34.000Z

liosha:

Клиент точно так же не обязателен, как и комментарий.

Время создания и время закрытия changeset-а слабо связано со временем начала и конца внесения правок.

Сам по себе changeset ничего логически не объединяет - он просто группирует, хотя можно сказать, что он предназначен для логического объединения.

UPD

Ну и опять же это определение учитывает только “послежизние” changeset-а после его закрытия.

Значит написать, что клиент и комментарий не обязательны. В целом же понятно о чём речь? Для определения достаточно, думаю…

liosha · 2009-10-08T11:35:26.000Z

Changeset - объект-идентификатор, к которому привязываются вносимые правки. Предназначен для логической группировки правок пользователя.

А дальше уже особенности:
имеет два этапа жизни - открыт (от создания до закрытия) и закрыт (после закрытия),
открытый может изменяться, после закрытия становится read-only,
каждая вносимая правка обязательно должна быть привязана к открытому changeset-у,
может иметь комментарий и доп. теги