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

Generate API docs for Toolpad Core #3536

Merged
merged 96 commits into from May 23, 2024

Conversation

apedroferreira
Copy link
Member

@apedroferreira apedroferreira commented May 9, 2024

Generate API docs for Toolpad Core - first the proptypes must be generated with pnpm proptypes and then API docs built with pnpm docs:build:api.

Restructured the documentation a bit kind of just to be more like the other MUI libraries I was taking the scripts from and what these scripts expect, but it's all for discussion of course!

API links from component pages are broken - if this PR looks good I think we can fix it here in the MUI monorepo: https://github.com/mui/material-ui/blob/next/packages/markdown/prepareMarkdown.js

API Page: https://deploy-preview-3536--mui-toolpad-docs.netlify.app/toolpad/core/api/app-provider/

@github-actions github-actions bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged label May 21, 2024
@apedroferreira

This comment was marked as resolved.

},
],
},
{
pathname: '/toolpad/core/components/filter-group',
Copy link
Member Author

Choose a reason for hiding this comment

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

Removing these but we can restore them back in the same way once we add more components, they might have been causing issues with the scripts.

children: [
{
pathname: '/toolpad/core/components/select-filter',
title: 'Select',
pathname: '/toolpad/core/react-dashboard-layout',
Copy link
Member Author

Choose a reason for hiding this comment

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

Not sure if we should follow this react-... naming pattern for pages, I saw all the other MUI libraries are doing it? But we can do it differently too.

@@ -49,6 +48,60 @@ const LogoContainer = styled('div')({
},
});

function ToolpadLogo({ size = 40 }: { size?: number }) {
Copy link
Member Author

Choose a reason for hiding this comment

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

Moved this component inside here as that's kind of how the scripts expect files to be organized, but it does take up a lot of lines...

@apedroferreira apedroferreira marked this pull request as ready for review May 22, 2024 21:30
@apedroferreira apedroferreira requested a review from a team May 22, 2024 21:31
@Janpot Janpot merged commit edc2117 into mui:master May 23, 2024
12 checks passed
@Janpot
Copy link
Member

Janpot commented May 23, 2024

Thanks! I removed an alias as it broke the demo formatter.

@apedroferreira apedroferreira deleted the generate-core-api-docs branch May 23, 2024 16:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
core Infrastructure work going on behind the scenes
Projects
Status: Completed
Development

Successfully merging this pull request may close these issues.

None yet

3 participants