APIs are flipping simple
How APIs are just child blocks, semantic versioning and what major releases are
Model of an API
The API is the hole.
In reality the shape is not a triangle but a structure of data (X contains Y) and format of the data (Y should be a number with no decimal places).
If you are working with an API, you are creating the block, they are managing the hole.
When things change
Things can change in three ways with APIs:
- PATCH — don’t change the shape
- MINOR — change the shape a bit
- MAJOR— completely change the shape
Don’t change the shape
This could be for things like performance improvements, small tweaks in method, or fixing simple bugs.
The short of it is that you will want to record that a change has happened (so it is easier for bug fixing) but to your users nothing has changed.
