Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs-infra] Add a rawDescriptions option #44390

Merged
merged 4 commits into from
Nov 13, 2024

Conversation

vladmoroz
Copy link
Contributor

Currently, api-docs-builder always renders JSDoc descriptions from markdown into HTML.

For the upcoming Base UI docs, we want the docs themselves to be responsible for rendering that so that component descriptions can be processed using the same MDX pipeline like the rest of the docs contents.

This PR adds a rawDescriptions option to ProjectSettings. When true:

  • JSDoc is not rendered into HTML
  • HTML entities aren’t escaped

No changes produced by docs:api:build in the current configs.

@vladmoroz vladmoroz added the scope: docs-infra Specific to the docs-infra product label Nov 12, 2024
@mui-bot
Copy link

mui-bot commented Nov 12, 2024

Netlify deploy preview

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

Bundle size report

No bundle size changes (Toolpad)
No bundle size changes

Generated by 🚫 dangerJS against 663e207

@vladmoroz vladmoroz requested review from alexfauquette and a team November 12, 2024 10:44
@vladmoroz vladmoroz merged commit 4c5d9eb into mui:master Nov 13, 2024
19 checks passed
@vladmoroz vladmoroz deleted the raw-descriptions branch November 13, 2024 12:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
scope: docs-infra Specific to the docs-infra product
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants