docs: pros & cons for dynamic variations when customizing

[dandv]

On the Customizing components page, under 2. Dynamic variation for a one-time situation, the docmentation reads,

You have learned how to override the style of a Material-UI component in the previous section. Now, let's see how we can make these overrides dynamic. Here are five alternatives; each has it's pros and cons.

What are these pros and cons?

[oliviertassinari]

• Dynamic CSS
  • pros: use the same syntax
  • cons: slower
• Class name branch
  • pros: avoid the above
  • cons: force to isolate states+
• CSS variables
  • pros: propagate instantly, faster
  • cons: no older browser support, fewer variable manipulation capability
• Inline-styles
  • pros: fast
  • cons: limited features, compared to CSS
• Theme nesting
  • pros: quick and dirty
  • cons: discourged.

[dandv]

Thanks! Should I add these to the docs, spread out to each method, or do you have other plans to link to this information?

[oliviertassinari]

I have been wondering about this when first introducing the different options. I went on the conclusion that new users would pick the first one (no need for pros/cons) and that advanced users would be interested to have their perspective broadened (no need for pros/cons).

Now, there is likely a middle ground here. The main challenge is to accurately explain the pros and cons.

[oliviertassinari]

Closing as I believe it's not important

[dandv]

new users would pick the first one (no need for pros/cons)

I'm a new user who likes to make informed choices. I never just pick the first option without understanding why. Maybe if I didn't care, and the docs said something like "in most cases you'll want to go with #1", then yes. But otherwise, with just a list of options and no guidance, how would I distinguish a list of 5 equally good options, from a list of 5 where the first is much better in most situations?

[oliviertassinari]

Agree, we can do better, what I meant is that it's a low ROI problem, better ignoring it to focus on something with more leverage (opportunity cost).