Versioning policy

Policy

The OpenTV Video Platform's APIs have the following versioning policy:

• Public APIs will be fully backward-compatible for at least two quarterly versions (six months).
  For example, if an API is changed in the 2020 Q1 release, the 2020 Q2 and Q3 releases will still support the old version, but support for the old version could be removed in the 2020 Q4 release.
• All changes to public APIs will be versioned.
• ION clients will operate with one previous and one upcoming quarterly platform release to allow users time to upgrade (with graceful feature fallback for new features).
  For example, the 2020 Q2 ION release will work with APIs from 2020 Q1, 2020 Q2, and 2020 Q3 Platform releases.

Naming convention

OpenTV Video Platform releases are named OTVS3_<yy>.<ww>STD<num>.

ION release bundles are named ION_<yy>.<ww>STD<num>. Each such bundle includes all applicable apps, each of which has its own x.y.z version number for app store purposes.

In both cases:

• <yy> is the year.
• <ww> is the week number.
• <num> is the release number within the quarter, starting at zero.