api-style-guide
api-style-guide copied to clipboard
Make versioning and the notion of evolving API more visible
Currently, the versioning of APIs is described under "URI components", which may not be prominent enough. Links between the following topics can be improved:
- Evolvable API design (don't versionize)
- Versioning (in case you screwed up and/or did a complete redesign)
- Hypermedia elements (which can also help creating evolvable APIs)
I have tried to make this more prominent. Can you check if it works for you.