Material-ui: [Select] Smaller demos

[ivanjeremic]

Can we have things like this removed from the docs? https://i.gyazo.com/93dc156541e3b7939022a4239747bd94.png

It makes it hard to find components that we need I would suggest 1 element per example.

[oliviertassinari]

Your link is not working

[ivanjeremic]

Your link is not working

fixed

[oliviertassinari]

We had a first iteration on this page to reduce the number of components on each demo. Cc @joshwooding, do you see any simplification potential left?

[ivanjeremic]

We had a first iteration on this page to reduce the number of components on each demo. Cc @joshwooding, do you see any simplification potential left?

Keep the number of examples the same only separate them, give every variation of for example this Select an own demo.

[oliviertassinari]

Which URL did you use?

[ivanjeremic]

Which URL did you use?

https://material-ui.com/components/selects/

But it's the same with almost every component.

[oliviertassinari]

Thanks, agree, I think that we could simplify the demos :)

[oliviertassinari]

Would you be interested in working on it?

[ivanjeremic]

Would you be interested in working on it?

I would have time from September until then I can't say 100%

[cjoecker]

@oliviertassinari I can take this.

So, my idea would be to separate the demos in max. 4 components per demo.
I think one demo per variant will make the page too long.

Another option I like, is when the variants can be selected and the code will be generated based on that.
Similar to the popover.

What do you think @ivanjeremic and @oliviertassinari ?

[oliviertassinari]

@cjoecker I don't know about a hard limit at 4, I think that we would benefit from creating smaller chunks, especially so that people spent less time scrolling the source of the demos. Playgrounds can be interesting, but only for the bottom of the page, I think that it makes it hard to discover the content.

[cjoecker]

@oliviertassinari good point. I was not thinking about a hard limit. I was more thinking about a balance of not too much scrolling because of too many small demos but also not too much scrolling because the examples are too long.

I will experiment a bit...

[ivanjeremic]

@cjoecker I don't know about a hard limit at 4, I think that we would benefit from creating smaller chunks, especially so that people spent less time scrolling the source of the demos. Playgrounds can be interesting, but only for the bottom of the page, I think that it makes it hard to discover the content.

I think people have no problem with scrolling, scrolling is easier than searching what belongs to the component you want in a big chunk of code example.