Начиная с V6 пространства имён не будут содержать номер версии API

В связи с появлением короткоживующих preview-версий и необходимостью частого перехода между ними решено убрать номер версии из пространства имён (namespaces). Сам файл с контрактами будет по-прежнему иметь имя вида Resto.Front.Api.Vx.dll, но все типы внутри будут расположены в пространстве имён Resto.Front.Api, поэтому вместо using Resto.Front.Api.Vx; теперь надо писать using Resto.Front.Api;.

При переходе на V6 надо будет напоследок обновить using’и, удалив номер версии. Благодаря этому перевод плагина с V6 на будущие версии (V7Preview1 и далее) упростится:

• Достаточно будет заменить ссылку (reference) со старой библиотеки (например, Resto.Front.Api.V6.dll) на новую (например, Resto.Front.Api.V7.dll), после чего останется осмысленно поправить только то, что реально поменялось между версиями. Никакой механической работы по обновлению using’ов.
• Результат (diff) будет компактным, его легче проверить (code review).
• В дальнейшем при параллельной поддержке плагина под разные версии API будет проще переносить изменения между ветками.

Ссылки на описания типов тоже поменялись, теперь в них номер версии присутствует единожды. Для сравнения:

• https://iiko.github.io/front.api.sdk/v5/html/T_Resto_Front_Api_V5_PluginContext.htm
• https://iiko.github.io/front.api.sdk/v6/html/T_Resto_Front_Api_PluginContext.htm

Релиз версии API V6 состоится осенью 2019, об этом будет отдельная новость.