forked fromsymfony/symfony-docs
- Notifications
You must be signed in to change notification settings - Fork0
Commit89c6f1d
committed
featuresymfony#3439 [Review] Added detailed Backwards Compatibility Promise text (webmozart)
This PR was merged into the 2.1 branch.Discussion----------[Review] Added detailed Backwards Compatibility Promise textI created a detailed text about which parts of the Symfony code are covered by our BC promise. The goals are to:* tell our users which parts exactly are safe to use* tell our contributors which changes they are allowed to doI'll continue working on the individual rules of allowed changes. Nevertheless, let me hear your feedback.##### Update (2014/01/10)The draft is ready for review now.Commits-------0717192 Removed useless line breakce58ee9 Added rules for adding parent interfaces and moving methods/properties to parent interfaces/classesbe2251c Implemented@fabpot's comments90c4de6 Mentioned Semantic Versioning in the introduction2320906 Extracted duplicated text into _api_tagging.rst.incbdd3c03 Implemented changes suggested by@wouterjfd1d912 Typo11bb879 Grammar25443c0 Improved table formattinge11335f Improved the wording of the "Using Symfony" section4868452 Added prose about the difference between regular/API classes/interfaces8c6c7bf Simplified usage description6d9edf1 Improved wording: Changed "safe" to "guaranteed"ef1f021 Added note about test classes5a160c5 Added note about deprecated interfaces/classes69768dd Improved wording: use -> call, access0c6420f Added information about changing parameter types6501a35 Added information about changing return types that are classes or interfacesdfb3e8b Improved wordingbe76644 Added information about internal classes and interfacesaf3a645 Added note about requesting `@api` tagsdcbe79a Improved wordingefd3911 Added that adding custom properties is not safe00c6ebe Fixed safety statements54fd836 Language improvementsdb76288 Fixed headingsc6e850d Language fixes4c5a55d Rearranged page to have different sections for different user bases502ed95 Added: Some breaking changes to unsafe operations are documented in the UPGRADE file31ab2db Improved wordinga3ad08c Removed most of the "cannot" statements which are repeated in the tables now345410c Rearranged safe operations to make more senseafadaab Changed: The last parameters of a method may be removed44ecf16 Fixed: No parameters must be added (ever) to API class methods0e925cb Added tables with safe operations79ca9f7 Added information about type compatibilitydacd7ce Rearranged rules to be more easily understandable7320ed0 Updated BC promise to be valid as of Symfony 2.3840073c Added detailed BC promise textFile tree
4 files changed
+377
-1
lines changed- contributing
- code
4 files changed
+377
-1
lines changedLines changed: 7 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
0 commit comments
Comments
(0)