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

Deletes core-principles/functional.md

Browse Source 
Auto commit by GitBook Editor
This commit is contained in:
apidesigner
2018-06-23 12:39:37 +00:00
parent eb491f8cb4
commit af1190a761
20 changed files with 178 additions and 171 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
general-guidelines/rules-for-extending.md Normal file
View File

@@ -0,0 +1,15 @@
# 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](core-principles/minimal-api-surface.md)
, [Robustness Principle](core-principles/robustness.md))
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](core-principles/robustness.md))
> NOTE: These rules cover also renaming and change to identifiers (URIs). Names and identifiers should be stable over the time including their semantics.