[materiaul-ui][Typography] Deprecate paragraph prop

[keul]

A small documentation issue at page https://material-ui.com/api/typography/

At props section (https://material-ui.com/api/typography/#props): inside the table paragraph and gutterBottom both reports If true, the text will have a bottom margin. which is confusing.

I guess is the paragraph description that is wrong.

---

Edit by @oliviertassinari.

A proposal: we deprecate the paragraph prop as they are likely already covered by the system props, e.g. mb.

[illuminist]

https://github.com/mui-org/material-ui/blob/cf75ed59666cb852f53f024ecaf57eb12fa64465/packages/material-ui/src/Typography/Typography.js#L72-L74

It also applies margin bottom, just a bit difference from what gutterBottom does.

[oliviertassinari]

This part of the Typography component is not pretty. I want to improve it since the release of v1. The documentation is not incorrect without being helpful. I would blame the implementation with the problem. I have personally almost never used the paragraph prop and use gutterBottom quite often.

What API would you like to see? As we are working toward moving the system into the core component, we should be able to leverage the m… props in the future.

[keul]

To be honest I'm not using paragraph or gutterBottom neither. I just found this repetition by reading the whole docs looking for other.

I'm not sure if any API of this kind is required here.

[oliviertassinari]

@keul How are you handling the spacing between two different Typography elements?

[keul]

I don't have much on them in my application right now, but I commonly use some className for this purpose

[oliviertassinari]

Ok, thanks for sharing.

[joshwooding]

I tend to use paragraph when I want to add spacing :/

[buchanaf]

Is there any reason for this component not to inherit the Box-style margin interface? I rarely use Typography because of this reason.

[oliviertassinari]

@buchanaf What do you mean by margin interface? Like <Typography mb={2} />?

[buchanaf]

@oliviertassinari, yes, exactly, including mx, my, etc.. Honestly, it'd be convenient for a lot of the more "primitive" components like Button.

[oliviertassinari]

@buchanaf <Button> already supports it in v5 under the sx prop. For the Typography, Box, Grid, Stack, 4 CSS utilities components, I have been advocating for having the subset of the system available as regular props.

[buchanaf]

Ah, good to know. I look forward to it! Good luck with the rest and thanks for your work!

[aarongarciah]

We are deprecating the paragraph prop in Typography for v6. We'll iterate on #42383