material-ui [pigment-css][react] Add a How Pigment CSS works guide

[x] I have followed (at least) the PR section of the contributing guide.

Mar 27 '24 12:03 brijeshb42

Netlify deploy preview

https://deploy-preview-41683--material-ui.netlify.app/

Bundle size report

No bundle size changes (Toolpad) No bundle size changes

Generated by :no_entry_sign: dangerJS against 68cacd0d748a7890c112831391f4360223ae6ade

Mar 27 '24 12:03 mui-bot

I was thinking of adding animations using Shiki to showcase the code-transforms. But since we are limited by plain markdown files, I didn't add it. It would be great if we are able to set-up Pigment CSS documentation within mui.com but using Pigment itself.

https://github.com/mui/material-ui/assets/717550/b01e570e-c05a-4f8e-b557-c483921dbbe3

Mar 29 '24 12:03 brijeshb42

That looks so good! I'd definitely be interested to have this on the docs-infra stack, too!

Mar 29 '24 13:03 danilo-leal

@samuelsycamore I've applied all your suggestions. Could you +1 if there's nothing else?

Apr 16 '24 12:04 brijeshb42