MozillaFoundation / mofo-standards

Mozilla Foundation – Engineering Guidebook
6 stars 2 forks source link

Describe API deprecation process #33

Open alanmoo opened 6 years ago

alanmoo commented 6 years ago

As per engineering etherpad:

API versioning

keep 2 versions and deprecate older (with notice)

for example: example.org/v1/ serve deprecation notice (error) example.org/v2/ previous API example.org/v3/ latest API

When deprecating/bumping major version- send engineering email, get confirmation response from everyone that it's good to deprecate