Skip to content
This repository was archived by the owner on Apr 12, 2024. It is now read-only.

Commit c10c6ca

Browse files
mgolNarretz
authored andcommitted
docs(faq): document the AngularJS/jqLite deprecation strategy
Fixes #15282
1 parent cee2c4c commit c10c6ca

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/content/misc/faq.ngdoc

+10
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,16 @@ extracted from the commits. We can quickly see in the new changelog exactly what
5555
changes and so can application developers when they are deciding whether to update to a new version of
5656
Angular.
5757

58+
#### When are deprecated features removed from the library?
59+
Most of the time we remove a deprecated feature in a next minor version bump. For example, the
60+
`preAssignBindingsEnabled` `$compileProvider` method was defined in AngularJS `1.5.10`, deprecated in `1.6` and
61+
will be removed in `1.7`.
62+
63+
In case of jqLite we apply a different strategy - we deprecate features that have an equivalent in jQuery that
64+
is also deprecated but we only remove the feature once it's removed from jQuery to improve compatibility between
65+
jqLite and jQuery. One such example is the `bind` method, deprecated in favor of `on` but unlikely to be removed
66+
from jqLite any time soon.
67+
5868

5969
### Is AngularJS a templating system?
6070

0 commit comments

Comments
 (0)