From: Bartosz Dziewoński <matma.rex@gmail.com>
Date: June 5, 2017 at 6:18:24 PM CDT
To: Wikimedia developers <wikitech-l@lists.wikimedia.org>
Subject: Re: [Wikitech-l] Fwd: OOjs UI 0.22.0 release (breaking change)
Reply-To: Wikimedia developers <wikitech-l@lists.wikimedia.org>
Some extra notes on the more interesting breaking/deprecating changes:
Breaking changes since last release:[...]* icons: Drop the deprecated core icon pack (James D. Forrester)Dropped 'core' icon pack, deprecated in v0.20.1 and already moved allof its iconsto different, more clearly labelled, icon packs back then. Now removedentirely.
This affects a large number of extensions. James and I have been working on
updating them on task T166730 [1], and all of the extensions in Wikimedia
production are by today updated (or have patches awaiting review), but a
few others still need updates. Feel free to help, especially for projects
you maintain.
[1] https://phabricator.wikimedia.org/T166730
Deprecations since last release:* Rename the 'MediaWiki' theme to 'WikimediaUI' (James D. Forrester)In order to clarify and simplify connection between the default theme'sdevelopment focus on Wikimedia user interfaces and connected resourceswe've decided to rename it. Currently there's an alias for the old name,whichshould allow your software to work as is. Still, consider renaming yourstyleand script references in the time being.
MediaWiki has been updated for this and this is unlikely to affect your
code, unless you hardcoded the theme name somewhere.[Deprecations since last release:]
* WindowManager: Deprecate using `openWindow`/`closeWindow` returns aspromises (Bartosz Dziewoński)The return value is now a WindowInstance object. Rather than using the"nested promises" to wait for window to open/close, you should instance useitsproperties (opening, opened, closing, closed) to wait for the givenstep of windowlifecycle.
This also affects a number of extensions, some in Wikimedia production.
I've updated a few of them on task T166729 [2], but more remain; feel free
to help, especially for projects you maintain. You will see deprecation
warnings for the deprecated usage.
[2] https://phabricator.wikimedia.org/T166729
On Tue, Jun 6, 2017 at 1:04 AM, James Forrester <jforrester@wikimedia.org>
wrote:Hello everyone,It looks like Volker's e-mail, below, didn't get distributed by the list onWednesday; re-sending now. With apologies.---------- Forwarded message ----------From: Volker Eckl <volker@wikimedia.org>Date: Wed, May 31, 2017 at 1:30 AMSubject: OOjs UI 0.22.0 release (breaking change)To: Wikimedia developers <wikitech-l@lists.wikimedia.org>Hello everyone,We've released OOjs UI 0.22.0, today. It will be in MediaWiki core from1.30.0-wmf.4, which will be deployed to Wikimedia production inthe regular train, starting on Tuesday 6 June. As there are three breakingchanges in this release, at least nominally, please carefully consider iftheyaffect your code.Breaking changes since last release:* TextInputWidget: Remove deprecated search related methods (PrateekSaxena)After being deprecated back in v0.18.0, we removed search relatedmethods entirely. The TextInputWidget got slimmed down and a morespecialized SearchInputWidget is available since November 2016.If you still use search methods, please switch over to SearchInputWidget.* icons: Drop the deprecated core icon pack (James D. Forrester)Dropped 'core' icon pack, deprecated in v0.20.1 and already moved allof its iconsto different, more clearly labelled, icon packs back then. Now removedentirely.* icons: Remove unused 'bookmark' icon (Volker E.)The 'bookmark' icon has been added, but has never been used inproduction nor is it planned, so it got removed.Deprecations since last release:* Rename the 'MediaWiki' theme to 'WikimediaUI' (James D. Forrester)In order to clarify and simplify connection between the default theme'sdevelopment focus on Wikimedia user interfaces and connected resourceswe've decided to rename it. Currently there's an alias for the old name,whichshould allow your software to work as is. Still, consider renaming yourstyleand script references in the time being.* WindowManager: Deprecate using `openWindow`/`closeWindow` returns aspromises (Bartosz Dziewoński)The return value is now a WindowInstance object. Rather than using the"nested promises" to wait for window to open/close, you should instance useitsproperties (opening, opened, closing, closed) to wait for the givenstep of windowlifecycle.Additional details are in the full changelog[0]. If you have anyfurther queries or need help dealing with breaking changes, please letme know. As always, a general set of library documentation isavailable on mediawiki.org[1], and there is some comprehensivegenerated code-level documentation and interactive demos hosted ondoc.wikimedia.org[2].[0] -https://phabricator.wikimedia.org/diffusion/GOJU/browse/master/History.md[1] - https://www.mediawiki.org/wiki/OOjs_UI[2] - https://doc.wikimedia.org/oojs-ui/master/Best,Volker--Senior UX Engineer, EditingWikimedia Foundationvolker.e [at] wikimedia | @Volker_E--James D. ForresterLead Product Manager, EditingWikimedia Foundation, Inc.jforrester at wikimedia.org<https://lists.wikimedia.org/mailman/listinfo/wikimedia-l> |@jdforrester_______________________________________________Wikitech-l mailing listWikitech-l@lists.wikimedia.orghttps://lists.wikimedia.org/mailman/listinfo/wikitech-l
--
Matma Rex
_______________________________________________
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l