[docs] Document sharing makeStyles between components

[johnraz]

• I have followed (at least) the PR section of the contributing guide.

Closes #15214

[johnraz]

@oliviertassinari please give it a look and see if it all make sense, thx!

[mui-pr-bot]

No bundle size changes comparing bd7f1e7...941434b

Generated by 🚫 dangerJS against 941434b

[oliviertassinari]

I had in mind something less practical but more generic around how the relative specificity works.

[johnraz]

I will read the source code to understand what exactly is going on and I’ll try to improve this.

[johnraz]

@oliviertassinari : would it be right to assimilate this doc about withStyles with makeStyles's behavior?

What I get from the doc above is that withStyles calling order defines the injection order.
I'm not 100% sure how an HOC and a hook compare in term of "precedence" here.
Is it right to say that the makeStyles calling order will define the injection order?

Sorry if that seems obvious but I'd better be safe than sorry here 😉

[oliviertassinari]

@johnraz I'm proposing an alternative wording, it's more generic. You shouldn't have to create a new makeStyle in each file. Imports should be working. Thanks for the JSS link, it was helpful.

[johnraz]

This is perfect! It actually answered the last doubts I had about how it works 👍🏻 Thanks for the welcoming exchange btw!

[oliviertassinari]

@johnraz Great :). Could you accept the @joshwooding's suggestions you agree with? Thanks.

[johnraz]

@oliviertassinari sure thing, I was on my phone before, needed the laptop to do it properly ;-)

[oliviertassinari]

@johnraz Thank you for the care in the problem.