- schemas/device-instance.schema.json, lines: 3-32, range
- schemas/device-model.schema.json, lines: 3-34, range
- schemas/labware.schema.json, lines: 3-3, range
- schemas/labware.schema.json, lines: 114-125, range
- schemas/labware.schema.json, lines: 212-223, range
- schemas/protocol.schema.json, lines: 3-35, range
Идентифицируйте схему стабильным строковым именем и положительным целочисленным номером ревизии. Первой опубликованной ревизии присваивайте номер 1. Увеличивайте номер при любом последующем опубликованном изменении структуры или семантики формата.
Документ должен ссылаться на схему объектом schema с полями name и revision.
Целочисленной ревизии достаточно, чтобы отличать опубликованные варианты схемы.
Считайте изменение обязательного поля несовместимым изменением.
-
MID: 0d503436e2e045b4ad31a23021022150 UID: VER-004 STATUS: DRAFT RELATIONS (Parent): RELATIONS (Child): STATEMENT: Публикуйте мигратор для каждой поддерживаемой несовместимой версии.
COMMENT: возможно избыточное требование
Считайте новое необязательное поле совместимым изменением.
-
MID: d2f086a0588d4c6a9fad0cc9573e197c UID: VER-002 STATUS: ACTIVE RELATIONS (Child): STATEMENT: Считайте изменение обязательного поля несовместимым изменением.
Публикуйте мигратор для каждой поддерживаемой несовместимой версии.
возможно избыточное требование
-
MID: e93faa1329334014bf4016c8b533f338 UID: VER-005 STATUS: ACTIVE RELATIONS (Parent): STATEMENT: Не изменяйте исходный файл при автоматической миграции.
-
MID: ca01394afe704eb2921a1a7172fef0c6 UID: VER-006 STATUS: ACTIVE RELATIONS (Parent): STATEMENT: Сохраняйте журнал миграции.
-
MID: 0d503436e2e045b4ad31a23021022150 UID: VER-004 STATUS: DRAFT RELATIONS (Parent): RELATIONS (Child): STATEMENT: Публикуйте мигратор для каждой поддерживаемой несовместимой версии.
COMMENT: возможно избыточное требование
Не изменяйте исходный файл при автоматической миграции.
-
MID: 0d503436e2e045b4ad31a23021022150 UID: VER-004 STATUS: DRAFT RELATIONS (Parent): RELATIONS (Child): STATEMENT: Публикуйте мигратор для каждой поддерживаемой несовместимой версии.
COMMENT: возможно избыточное требование
Сохраняйте журнал миграции.
Определите окно поддержки старых версий.
Храните примеры каждой опубликованной версии.
возможно избыточно, для этого будут использоваться git tags