Skip to content

Conversation

@siriwatknp
Copy link
Member

@siriwatknp siriwatknp commented Sep 18, 2025

closes mui/mui-public#717

Root cause

The issue was that the Typography component's documentation wasn't being generated because:

  1. Multiple markdown files (breadcrumbs.md and typography.md) listed Typography as a component
  2. The script was using the first demo file found (alphabetically breadcrumbs.md came first)
  3. This caused the Typography documentation to be incorrectly associated with the Breadcrumbs page

Others

Fix the logic for non component markdown files to use pages.ts as a source of truth to find markdown pages.
This fix will ensure that the url has .md without manual selection.

Result

All valid now (from the deploy preview):

https://deploy-preview-46954--material-ui.netlify.app/material-ui/react-transfer-list.md
https://deploy-preview-46954--material-ui.netlify.app/material-ui/react-typography.md
https://deploy-preview-46954--material-ui.netlify.app/material-ui/react-popper.md
https://deploy-preview-46954--material-ui.netlify.app/material-ui/react-badge.md
https://deploy-preview-46954--material-ui.netlify.app/material-ui/react-link.md
https://deploy-preview-46954--material-ui.netlify.app/material-ui/react-use-media-query.md
https://deploy-preview-46954--material-ui.netlify.app/material-ui/react-paper.md


@mui-bot
Copy link

mui-bot commented Sep 18, 2025

Netlify deploy preview

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

Bundle size report

Bundle Parsed size Gzip size
@mui/material 0B(0.00%) 0B(0.00%)
@mui/lab 0B(0.00%) 0B(0.00%)
@mui/system 0B(0.00%) 0B(0.00%)
@mui/utils 0B(0.00%) 0B(0.00%)

Details of bundle changes

Generated by 🚫 dangerJS against ff5b552

@siriwatknp siriwatknp requested a review from Janpot September 18, 2025 10:28
@zannager zannager added the scope: docs-infra Involves the docs-infra product (https://www.notion.so/mui-org/b9f676062eb94747b6768209f7751305). label Sep 18, 2025
@siriwatknp siriwatknp force-pushed the infra/fix-llms-script branch from 14b3c08 to 8c33474 Compare September 19, 2025 03:40
if (!projectSettings.pagesManifestPath) {
return [];
}
const pagesContent = fs.readFileSync(projectSettings.pagesManifestPath, 'utf-8');
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Janpot I have updated to use pages as source of truth to generate markdown files for non component.

Copy link
Member

@Janpot Janpot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@siriwatknp siriwatknp merged commit 770c1e8 into mui:master Sep 19, 2025
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

scope: docs-infra Involves the docs-infra product (https://www.notion.so/mui-org/b9f676062eb94747b6768209f7751305).

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs-infra] Missing markdown pages

4 participants