[docs] System Typography page is first search result for Typography

[danawoodman]

Seems strange that the docs site shows <Box> components for the <Typography> docs:

https://material-ui.com/system/typography/#typography

[mbrookes]

That's the Typography page for the System package. The Typography docs are here:

https://material-ui.com/components/typography/
https://material-ui.com/api/typography/

Perhaps we somehow need to make it clearer what section a page belongs to.

[danawoodman]

Ah, that wasn't obvious. That page is the first result when searching for "Typography":

[mbrookes]

I noticed that too. I think we should leave this open for now.

[mbrookes]

I've changed the subject to reference the search result as that's the entry point to the source of confusion, but I also think we could make the distinction clearer on the page. (Add breadcrumbs? Change the System page headings to "System – Pagination"? Something else?)

[joshwooding]

Is there a way to show component pages first as well? I would expect most searches are looking for the component pages rather than the System pages.

[mbrookes]

Is there a way to show component pages first as well?

That was the main point, as reflected by the change of subject. @oliviertassinari would be best to answer, as he has singularly developed the Algolia integration.

[oliviertassinari]

I think that the introduction of a breadcrumb has potential.
Regarding Algolia, I have no idea how they rank the content in this case. I believe we have another issue open related to improving the ranking of Algolia. For instance, I have noticed that, sometimes, it display the component page before the API page, sometime, the opposite.

[siriwatknp]

I added my findings here, will try to fix it. #16502 (comment)

[siriwatknp]

This is fixed. Here is the proof