Material-components-web: Migration Guide from MDL to MDC

[SabineMa]

This is not a Feature Request and not a bug but the question: will you provide a migration guide for people using MDL and want to migrate to MDC?

[sgomes]

Thanks for the suggestion, @SabineMa! There's a big difference between the two, but it could prove useful as a complement to our Getting Started guide. @traviskaufman What do you think?

[igilham]

This would definitely be useful to anyone who uses MDL and wants to migrate.

[sgomes]

We've discussed this question a bit and think there's a few things that could be useful in a migration guide. Let me try to summarize them:

• [x] List of components in MDC-Web and MDL, and how they map to each other.
• [x] Discussion of the different ways of depending on / using MDL, and the high-level changes you have to make to move from MDL to MDC-Web with each one. Plus discuss the new options only available in MDC-Web.
• [x] Discussion of whether or not to use mdc-auto-init (auto initialization is mandatory in MDL, but not in MDC-Web).

All of this peppered with plenty of links into the existing MDC-Web documentation, for finding out more. How does this sound, @SabineMa @traviskaufman @amsheehan?

[ohdoukyoung]

I wonder if the scope of the browser support is also included in the migration guide.
Are there any plans to support IE9-10 like MDL?

[sgomes]

@ohdoukyoung No plans for IE9-10 in MDC-Web, sorry; it's missing too much, like flexbox and calc. We'll add that info to the guide.

[SabineMa]

Only for the sake of completeness

• List of NEW components in MDC-Web

[igilham]

At present there are also missing components in MDC-Web so these could be highlighted in the mappings from MDL to MDC-Web.

[sgomes]

@SabineMa Yes, sounds good!

@igilham Yep, good idea. It might also be useful have the indication of whether those missing components are planned for later, and which milestone (beta or stable) they're planned for.

[sgomes]

This is now merged.