Open-Network-Models-and-Interfaces-ONMI / TAPI

LF ONMI Transport API Repository (TAPI)
https://github.com/Open-Network-Models-and-Interfaces-ONMI/TAPI/wiki
Apache License 2.0
95 stars 80 forks source link

Backward compatibility clarification #358

Closed italobusi closed 5 years ago

italobusi commented 5 years ago

As agreed in the IMP call on September 27, 2018, backward compatibility issues (e.g. issue #282) will not be addressed in R2.1 but in a future release and the status will be reported in R2.1 release notes:

https://wiki.opennetworking.org/display/OIMT/2018-09-27+OIMT+Meeting+Notes

italobusi commented 5 years ago

Initial proposed text for TAPI 2.1 release note:

ONF TAPI release process does not guarantee backward compatibility among different TAPI versions

TAPI R2.1 models are not backward compatible with previous TAPI releases (e.g., R2.0.2). There is no guarantee that the next TAPI release (e.g., R2.1.1) will be backward compatible with R2.1

It is expected that backward compatibility issues will be addressed by ONF for further releases

italobusi commented 5 years ago

ONF TAPI release process does not guarantee backward compatibility of YANG models, as outline in section 10 of https://tools.ietf.org/html/rfc6020, among different TAPI major versions

TAPI R2.1 YANG models are not backward compatible with previous TAPI releases (e.g., R2.0.2)

italobusi commented 5 years ago

Better to reference the RFC7950 instead of RFC6020:

ONF TAPI release process does not guarantee backward compatibility of YANG models, as outline in section 11 of https://tools.ietf.org/html/rfc7950, among different TAPI major versions

TAPI R2.1 YANG models are not backward compatible with previous TAPI releases (e.g., R2.0.2)

karthik-sethuraman commented 5 years ago

As per the TAPI call on 10/2/18 (https://wiki.opennetworking.org/display/OTCC/2018-10-02+TAPI+Meeting+Notes), I would propose the following text

- ONF TAPI release process does not guarantee backward compatibility of YANG models across major versions of TAPI releases. The Yang model backward compatibility criteria is outlined in section 10 of (https://tools.ietf.org/html/rfc7950) 
- TAPI R2.1 YANG models are not backward compatible with previous TAPI releases