api-blueprint-rfcs icon indicating copy to clipboard operation
api-blueprint-rfcs copied to clipboard

Published 20 hours ago • verified publisher icon apiaryio

Introduce semantic versioning for APIB

Open kylef opened this issue 9 years ago • 1 comments
trafficstars

This RFC proposes that the API Blueprint language and specification are versioned via Semantic Versioning, and there is a CHANGELOG file including a list of changes for each release.

kylef avatar Feb 09 '16 09:02 kylef

I am okay with this, but I wonder about backward compatibility. Also, there are a few things that need to be finalised. Like:

  • Will we support multiple versions of APIB? Or is it always going to be the latest version?
  • APIB is pretty stable, so I don't know if we really need the major and minor numbers from semantic versioning.

This sounds like a good idea, but "if it ain't broke don't fix it"

pksunkara avatar Apr 06 '16 11:04 pksunkara