api-style-guide icon indicating copy to clipboard operation
api-style-guide copied to clipboard

Make versioning and the notion of evolving API more visible

Open DonMartin76 opened this issue 10 years ago • 1 comments

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)

DonMartin76 avatar Mar 14 '16 10:03 DonMartin76

I have tried to make this more prominent. Can you check if it works for you.

hlgr360 avatar Jun 30 '16 15:06 hlgr360