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

Commit 8fb171b

Browse files
committed
docs(faq): document the AngularJS/jqLite deprecation strategy
Fixes #15282
1 parent 38f8c97 commit 8fb171b

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

docs/content/misc/faq.ngdoc

+9
Original file line numberDiff line numberDiff line change
@@ -130,6 +130,15 @@ AngularJS 1.3 only supports jQuery 2.1 or above. jQuery 1.7 and newer might work
130130
but we don't guarantee that.
131131

132132

133+
### When will the deprecated features be removed from the library?
134+
Most of the time we remove a deprecated feature in a next minor bump. For example, the `preAssignBindingsEnabled`
135+
`$compileProvider` method was defined in AngularJS `1.5.10`, deprecated in `1.6` and will be removed in `1.7`.
136+
137+
In case of jqLite we apply a different strategy - we deprecate features that have an equivalent in jQuery that
138+
is also deprecated but we only remove the feature once it's removed from jQuery to improve compatibility between
139+
jqLite and jQuery. One such example is the `bind` method, deprecated in favor of `on` but unlikely to be removed
140+
from jqLite any time soon.
141+
133142
### What is testability like in AngularJS?
134143

135144
Very testable and designed this way from the ground up. It has an integrated dependency injection

0 commit comments

Comments
 (0)