Versioning
==========

Major Versions
--------------
Major versions of the BrAPI spec are accompanied by broad changes to the whole specification. Major versions are not backward compatible with each other. 
When a new major version is built, all the deprecated fields are permanently removed, allowing for a clean slate to start again. 
This is why it is important to indicate the major version in the URL for every BrAPI call. If a server needs to support multiple major versions of the spec,
each version will be implemented under a different base path. 

Minor Versions
--------------
Minor versions are typically smaller updates to the spec, fixing a group of smaller github issues like new search parameters, additional data fields, and mistakes not following best practice. 
Minor versions are backward compatible, so a single response can have all the data fields necessary to support the needs of multiple minor versions. 


Deprecation
-----------
Deprecated fields, parameters, and endpoints indicate that something has been removed or replaced in a minor version update.