Mirrors/api-guidelines
1
0
Fork 0
mirror of https://github.com/adidas/api-guidelines.git synced 2025-10-25 15:19:19 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
f8e0f3b1e43e3f2004eeb83571816417515c6c11
api-guidelines/core-principles/rules-for-extending.md
apidesigner 01eec77419 Updates core-principles/rules-for-extending.md 
Auto commit by GitBook Editor
2017-02-01 16:04:55 +00:00

748 B
Raw Blame History

Rules for Extending

Any modification to an existing API MUST avoid breaking changes and MUST maintain backward compatibility.

In particular, any change to an API MUST follow the following Rules for Extending:

  1. You MUST NOT take anything away (related: Minimal Surface Principle , Robustness Principle)
  2. You MUST NOT change processing rules
  3. You MUST NOT make optional things required
  4. Anything you add MUST be optional (related Robustness Principle)

NOTE: These rules covers also renaming and changes to identifiers (URIs). Names and identifiers should be stable over the time including their semantics.