| Table of Contents |
|---|
...
- Utilizes the same semantic versioning methodology that is being used for ONAP’s Release Versioning Strategy; therefore, development teams are familiar with the definition of the methodology.
- For a given a version number, MAJOR.MINOR.PATCH, increment the:
- MAJOR position when you make any incompatible API or component change
- MINOR position when you add functionality in a backwards-compatible manner
- PATCH (or BUILD) position when you make invisible (and thus backwards-compatible) bug fixes
- Details of the specification can be found at http://semver.org/
...
- REST APIs Must be Hypertext-Driven: Blog post where Roy Fielding argues that not any HTTP-based interface is a REST API
- RESTful API Design Specification (for ONAP)
- REST APIs don’t need a versioning strategy – they need a change strategy