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
b5806e2a26ec9ed040740cb806f0dfbbd3871174
api-guidelines/core-principles/rules-for-extending.md
apidesigner 5f1c5ff520 Updates core-principles/rules-for-extending.md 
Auto commit by GitBook Editor
2017-01-31 14:33:11 +00:00

762 B
Raw Blame History

Rules for Extending

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

In particular, any change to an API design 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.