PDA

View Full Version : Ext.util.Observable - Summary is contradictory



LesJ
6 Sep 2017, 11:28 AM
This is the summary (https://docs.sencha.com/extjs/6.5.1/classic/Ext.util.Observable.html):

"A Ext.mixin.Observable subclass that is provided for backward compatibility. Applications should avoid using this class, and use Ext.mixin.Observable instead."

This summary is contradictory. It's says don't use A; instead, use A.

If applications should avoid using Ext.util.Observable, then this class should be deprecated. :-?

evant
7 Sep 2017, 2:48 AM
It's saying to use the mixin directly, as a mixin, as opposed to extending from Ext.util.Observable.

LesJ
7 Sep 2017, 3:53 AM
It's saying to use the mixin directly, as a mixin, as opposed to extending from Ext.util.Observable.

Should it be deprecated if applications should avoid using this class?

This is a minor comment, but the sentence would be clearer if it started with the article An, not A.