replace /v4/ with /stable/ and /dev/ (original) (raw)
currently /v3 is used by Firefox and by addons-frontend, so has to stable but also frozen. We'd like addons-frontend to use the newer version of the api that has new features but it creates an up front challenge - all the changes have to be supported straight away before they can upgrade. And once they do support /v4 then then new changes rolled out are a little inconvenient because we can't make breaking changes without coordination.
So instead lets have a /stable that addons-frontend can use, and a /dev that has all the new features. Initially /stable will only have the backwards compatible gates enabled that addons-frontend can use right now, and then as further development is made more gates can be toggled.