Versioning

​

Overview

Developing a clear and comprehensive versioning strategy is a best practice when maintaining a standards-based project. For the canonical version used to describe the Mesh APIs, see mesh-specifications/releases.

We recommend that you use independent versioning for your implementation of Mesh APIs. You must explicitly state the Mesh API version(s) with which it is compatible. We recommend the same for SDK versioning.

Check out these repositories for examples of how we built codegen toolchains for Golang:

• mesh-sdk-go
• mesh-geth-sdk

​

A Note About New SDKs

If you choose to implement the Mesh APIs in a language that does not yet have a supported SDK, we recommend creating a separate project for generating code from the specifications, instead of embedding code generation into your implementation.

This will make managing specification updates and versioning much easier.