Templarian/MaterialDesign

RELEASED - Version 6.1.95 - Breaking Changes

Closed this issue · 14 comments

mririgoyen commented

Version 6.1.95 was released on Monday, September 6th, 2021.

We are now at the halfway point between v5 and v6, so I felt that it would be appropriate to have a single resource tracking all upcoming breaking changes that will be introduced in our v6 release. This issue will be kept updated as we get closer and closer to release and then will act as a reference.

Icons Being Removed (41)

The follow icons have been deprecated and will be removed entirely:

  • adobe (#5797)
  • adobe-acrobat (#5797)
  • amazon
  • amazon-alexa
  • android-auto
  • android-debug-bridge
  • bandcamp
  • battlenet
  • blogger
  • buffer
  • cash-usd (#5661)
  • cash-usd-outline (#5661)
  • cellphone-android (#5276)
  • cellphone-iphone (#5276)
  • concourse-ci
  • currency-usd-circle (#5661)
  • currency-usd-circle-outline (#5661)
  • do-not-disturb (#5135)
  • do-not-disturb-off (#5135)
  • douban
  • file-pdf (#5797)
  • file-pdf-outline (#5797)
  • file-pdf-box-outline (#5797)
  • google-photos (#5293)
  • home-currency-usd (#5661)
  • laptop-chromebook (#5276)
  • laptop-mac (#5276)
  • laptop-windows (#5276)
  • microsoft-edge-legacy
  • microsoft-yammer
  • pdf-box (#5797)
  • plus-one (#5408)
  • poll-box (#5885)
  • poll-box-outline (#5885)
  • tablet-ipad (#5276)
  • telegram (#5275)
  • untappd
  • vk
  • xamarian-outline
  • xing
  • y-combinator

Icons Being Renamed (51)

The following icons are being renamed:

  • apple-airplay ➜ cast-variant (#5376)
  • application ➜ application-outline (#6087)
  • application-cog ➜ application-cog-outline (#6087)
  • application-settings ➜ application-settings-outline (#6087)
  • bolnisi-cross ➜ cross-bolnisi (#5803)
  • boom-gate-up ➜ boom-gate-arrow-up (#6008)
  • boom-gate-up-outline ➜ boom-gate-arrow-up-outline (#6008)
  • boom-gate-down➜ boom-gate-arrow-down (#6008)
  • boom-gate-down-outline ➜ boom-gate-arrow-down-outline (#6008)
  • buddhism ➜ dharmachakra (#5541)
  • cellphone-erase ➜ cellphone-remove (#5874)
  • celtic-cross ➜ cross-celtic (#5803)
  • check-box-multiple-outline ➜ checkbox-multiple-outline (#5914)
  • check-box-outline ➜ checkbox-outline (#5914)
  • christianity ➜ cross (#5541)
  • christianity-outline ➜ cross-outline (#5541)
  • face ➜ face-man (#5675)
  • face-outline ➜ face-man-outline (#5675)
  • face-profile ➜ face-man-profile (#5675)
  • face-profile-woman ➜ face-woman-profile (#5675)
  • face-shimmer ➜ face-man-shimmer (#5675)
  • face-shimmer-outline ➜ face-man-shimmer-outline (#5675)
  • flash-circle ➜ lightning-bolt-circle
  • floor-lamp-variant ➜ floor-lamp-torchiere-variant (#4945)
  • gif ➜ file-gif-box (#5830)
  • gradient ➜ gradient-vertical (#5285)
  • hand ➜hand-front-right (#6165)
  • hand-left ➜ hand-back-left (#6165)
  • hand-right ➜ hand-back-right (#6165)
  • hinduism ➜ om (#5541)
  • human-greeting ➜ human-greeting-variant (#6148)
  • iframe ➜ application-brackets (#6087)
  • iframe-outline ➜ application-brackets-outline (#6087)
  • iframe-array ➜ application-array (#6087)
  • iframe-array-outline ➜ application-array-outline (#6087)
  • iframe-braces ➜ application-braces (#6087)
  • iframe-braces-outline ➜ application-braces-outline (#6087)
  • iframe-parentheses ➜ application-parentheses (#6087)
  • iframe-parentheses-outline ➜ application-parentheses-outline (#6087)
  • iframe-variable ➜ application-variable (#6087)
  • iframe-variable-outline ➜ application-variable-outline (#6087)
  • islam ➜ star-crescent (#5541)
  • judaism ➜ star-david (#5541)
  • monitor-clean ➜ monitor-shimmer (#5400)
  • pharmacy ➜ mortar-pestle-plus (#5478)
  • sparkles ➜ shimmer (#5400)
  • teach ➜ human-male-board (#4959)
  • television-clean ➜ television-shimmer (#5400)
  • text-subject ➜ text-long (#4968)
  • twitter-retweet ➜ repeat-variant (#5455)
  • voice-off ➜ account-voice-off (#5269)

FAQ

When will v6 be released?

Version 6.1.95 was released on Monday, September 6th, 2021.

What's up with your version numbers?

We do not follow semver. Our version number indicates how many icons are available in the icon pack. However, we do try to lump as many breaking changes as possible into major version releases (so every 1000 icons). We aim to add approximately 100 icons per minor version release. We sometimes make breaking changes in minor version releases, so it is always important to look at our changelog when updating.

Sjoerd82 commented

How does this impact people that use Material Design icons via frameworks, like Vuetify?

Simran-B commented

@Sjoerd82 It's a breaking change. If you upgrade to v6 you will have to change the icon names in code, unless Vuetify provides a compatibility layer. That applies to renamed icons, for removed ones you can either pick another icons if there is a suitable one, or use a third-party icon set to fill the gap like http://simpleicons.com/ for brand icons.

Simran-B commented

Should we rename the face-woman* icons to face-female* for consistency? They are the only ones with "woman" in them, and we have none with "man" (well, except pac-man...)

mririgoyen commented

Should we rename the face-woman* icons to face-female* for consistency? They are the only ones with "woman" in them, and we have none with "man" (well, except pac-man...)

Let's open up issues for proposed breaking changes and leave this for a summary or discussion about the changes as a whole.

Simran-B commented

google-photos should be removed. We don't have the latest design (see #5293) and it's a brand icon anyway. The pinwheel icons will remain.

bootstrap should also be removed. They updated their logo with v5 (currently in beta, also see #5238) and it's a brand icon.

mririgoyen commented

I've updated #5293 and marked google-photos as deprecated. We'll leave bootstrap alone for now because it is a developer tool and that falls in the realm of our accepted icons. Consider it grandfathered in.

Templarian commented

I added a note to address finally dropping the other font files as suggested in this issue: Templarian/MaterialDesign-Webfont#59

Going to take it one step further and only bundle Woff2 after 6.0 This means anyone targeting IE11 will need to use an older version. Almost all large companies are dropping IE11 support in 2021 so this is a good time for us.

digitalpoin commented

Please update car icon for "car door open"

mririgoyen commented

Please update car icon for "car door open"

@digitalpoin I'm not sure what you are asking here, please open a new issue if you have a request for a new icon or an icon update. Thank you!

digitalpoin commented

Please update car icon for "car door open"

@digitalpoin I'm not sure what you are asking here, please open a new issue if you have a request for a new icon or an icon update. Thank you!

Oh sorry. I am just suggesting to add an "open door car" icon in MaterialDesignIcons for the next version. Thank you in advance.

zgover commented

@goyney would you mind editing the original issue content—providing brief insights of the icon task list under 'Icons Being Removed'—specify either name of alternative or aliased resolution or just icon EOL decision. This will enable support for substantially greater consumer awareness while migrating; saving time, resources and energy by minimizing page navigations to the respective icon issue.

mririgoyen commented

@goyney would you mind editing the original issue content—providing brief insights of the icon task list under 'Icons Being Removed'—specify either name of alternative or aliased resolution or just icon EOL decision. This will enable support for substantially greater consumer awareness while migrating; saving time, resources and energy by minimizing page navigations to the respective icon issue.

This issue serves as that reference. Each linked issue contains more information if absolutely needed. The TL;DR is that we are deprecated and removing most brand icons and pointing people to SimpleIcons for brand icon needs. Brand icons carry a certain amount of risk so we are slowly reducing that surface area.

juhasev commented

I think we should take it easy on renaming and deleting icons. This is a major burden to update hundreds of icons currently in use especially the ones that got deleted.

  • 👍4
  • 👎2
mririgoyen commented

I think we should take it easy on renaming and deleting icons. This is a major burden to update hundreds of icons currently in use especially the ones that got deleted.

We do not make breaking changes lightly. However, when we do, we align them to the major breaking version change (in this case v5 ➜ v6). You are not required to update, but if you do, you will need to update any places in which you are affected by the changes. This is the case for nearly every piece of open-source software out there.

It's also important to note that we don't follow semver here. So, we literally amass breaking changes over the course of building up another 1000 new icons. This usually happens over the course of about 10 months, so when a major version comes, it's important we take our time.

Please use this issue as your migration path once v6 is released if you chose to upgrade.