On Thu, Jan 13, 2011 at 1:13 PM, Vincent Massol <[email protected]> wrote: > Hi devs, > > I think the start of the XE 3.x cycle is a good time to remove some > deprecated methods/classes. > > We have a deprecation strategy defined already: > http://dev.xwiki.org/xwiki/bin/view/Community/DevelopmentPractices#HDeprecationStrategy > > " > Our rule is to keep @deprecated methods/classes for 2 final releases after > the version where they were first added has been released as final. > > For example if a method is deprecated in, say XE 1.3M2 then the method will > be removed in 1.6M1 or after. Of course any major new release can deprecate > anything. For example a XWiki 2.0 release is allowed to break backward > compatibility (obviously we need to be careful to offer a migration path for > users of previous major versions). > " > > So 2 final releases mean that deprecations introduced in 2.5.x or before can > theoretically be removed for XE 3.0 final. > > However, IMO we shouldn't remove deprecated methods/classes that are public > for scrips since this will break xwiki users. > > Are we ok to do that? > > Personally I'm fine and I'd like to add this caveat to the best practice if > we agree.
+1, and I'd like to add it as a best practice for JavaScript as well. Jerome. > > Thanks > -Vincent > > _______________________________________________ > devs mailing list > [email protected] > http://lists.xwiki.org/mailman/listinfo/devs > _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
