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
7089a60a0307aed9efaf80992ac58af00f190e8d
api-guidelines/core-principles/rules-for-extending.md
apidesigner 7089a60a03 Updates core-principles/rules-for-extending.md 
Auto commit by GitBook Editor
2017-01-31 12:37:24 +00:00

761 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.