Starting from V6, namespaces will not contain the API version number
Due to the emergence of short-lived preview versions and the need for frequent transitions between them, it has been decided to remove the version number from the namespaces.
The contract file will still have a name of the form Resto.Front.Api.Vx.dll, but all types inside will be located in the namespace Resto.Front.Api, so instead of using Resto.Front.Api.Vx;, you now need to write using Resto.Front.Api;.
When transitioning to V6, you will need to finally update the usings by removing the version number. As a result, the translation of the plugin from V6 to future versions (V7Preview1 and beyond) will be simplified:
- It will be enough to replace the reference from the old library (for example, Resto.Front.Api.V6.dll) to the new one (for example, Resto.Front.Api.V7.dll), after which you will only need to meaningfully adjust what has actually changed between versions. No mechanical work on updating usings.
- The result (diff) will be compact, making it easier to review (code review).
- In the future, when supporting the plugin for different API versions in parallel, it will be easier to transfer changes between branches.
Links to type descriptions have also changed; now the version number appears only once in them. For comparison:
- https://syrve.github.io/front.api.sdk/v5/html/T_Resto_Front_Api_V5_PluginContext.htm
- https://syrve.github.io/front.api.sdk/v6/html/T_Resto_Front_Api_PluginContext.htm
The release of API version V6 will take place in the autumn of 2019, and there will be a separate announcement about it.