Skip to content

[docs] Rename migration pages to upgrade #22022

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.

Sign up for GitHub

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

Draft
mnajdova wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

[docs] Rename migration pages to upgrade #22022

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ Same changes as in `@mui/x-data-grid-pro@9.0.0-rc.0`, plus:

#### Breaking changes

- Accessible DOM structure is now the only default. [Read more](https://mui.com/x/migration/migration-pickers-v8/#accessible-dom-structure-is-now-the-default)
- The `PickerDay2` and `DateRangePickerDay2` components were propagated to stable while removing the previous defaults. [Read more](https://mui.com/x/migration/migration-pickers-v8/#day-slot)
- Accessible DOM structure is now the only default. [Read more](https://mui.com/x/migration/upgrade-pickers-to-v9/#accessible-dom-structure-is-now-the-default)
- The `PickerDay2` and `DateRangePickerDay2` components were propagated to stable while removing the previous defaults. [Read more](https://mui.com/x/migration/upgrade-pickers-to-v9/#day-slot)

#### `@mui/x-date-pickers@9.0.0-rc.0`

Expand Down
2 changes: 1 addition & 1 deletion docs/data/date-pickers/custom-components/custom-components.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -227,7 +227,7 @@ This change brings several benefits:
However, this might affect your custom styles if you were targeting the nested elements.
For example, in `DateRangePickerDay`, the `day` class has been removed because there is no longer a separate element for the day content.

For more details on how to adapt your custom styles, check the [Day slot migration guide](/x/migration/migration-pickers-v8/#day-slot).
For more details on how to adapt your custom styles, check the [Day slot migration guide](/x/migration/upgrade-pickers-to-v9/#day-slot).

### Examples

Expand Down
2 changes: 1 addition & 1 deletion ...igration-charts-v8/migration-charts-v8.md → ...rade-charts-to-v9/upgrade-charts-to-v9.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ This is a reference guide for upgrading `@mui/x-charts` from v8 to v9.
<!-- Overall theme of this major, fixing API inconsistencies, improving customization, etc -->

:::success
This guide is also available in <a href="https://raw.githubusercontent.com/mui/mui-x/refs/heads/master/docs/data/migration/migration-charts-v8/migration-charts-v8.md" target="_blank">Markdown format</a> to be referenced by AI tools like Copilot or Cursor to help you with the migration.
This guide is also available in <a href="https://raw.githubusercontent.com/mui/mui-x/refs/heads/master/docs/data/migration/upgrade-charts-to-v9/upgrade-charts-to-v9.md" target="_blank">Markdown format</a> to be referenced by AI tools like Copilot or Cursor to help you with the migration.
:::

## Prepare for the migration
Expand Down
2 changes: 1 addition & 1 deletion ...on-data-grid-v8/migration-data-grid-v8.md → ...ata-grid-to-v9/upgrade-data-grid-to-v9.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ productId: x-data-grid
This is a reference guide for upgrading `@mui/x-data-grid` from v8 to v9.

:::success
This guide is also available in <a href="https://raw.githubusercontent.com/mui/mui-x/refs/heads/master/docs/data/migration/migration-data-grid-v8/migration-data-grid-v8.md" target="_blank">Markdown format</a> to be referenced by AI tools like Copilot or Cursor to help you with the migration.
This guide is also available in <a href="https://raw.githubusercontent.com/mui/mui-x/refs/heads/master/docs/data/migration/upgrade-data-grid-to-v9/upgrade-data-grid-to-v9.md" target="_blank">Markdown format</a> to be referenced by AI tools like Copilot or Cursor to help you with the migration.
:::

## Start using the new release
Expand Down
0 ...ration-pickers-v8/migration-pickers-v8.md → ...de-pickers-to-v9/upgrade-pickers-to-v9.md
View file
Open in desktop
File renamed without changes.
0 ...on-tree-view-v8/migration-tree-view-v8.md → ...ree-view-to-v9/upgrade-tree-view-to-v9.md
View file
Open in desktop
File renamed without changes.
11 changes: 7 additions & 4 deletions docs/data/pages.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -864,17 +864,20 @@ const pages: MuiPage[] = [
pathname: '/x/migration-v9',
subheader: 'Upgrade to v9',
children: [
{ pathname: '/x/migration/migration-data-grid-v8', title: 'Breaking changes: Data Grid' },
{
pathname: '/x/migration/migration-pickers-v8',
pathname: '/x/migration/upgrade-data-grid-to-v9',
title: 'Breaking changes: Data Grid',
},
{
pathname: '/x/migration/upgrade-pickers-to-v9',
title: 'Breaking changes: Date and Time Pickers',
},
{
pathname: '/x/migration/migration-charts-v8',
pathname: '/x/migration/upgrade-charts-to-v9',
title: 'Breaking changes: Charts',
},
{
pathname: '/x/migration/migration-tree-view-v8',
pathname: '/x/migration/upgrade-tree-view-to-v9',
title: 'Breaking changes: Tree View',
},
],
Expand Down
2 changes: 1 addition & 1 deletion ...pages/x/migration/migration-pickers-v8.js → ...pages/x/migration/upgrade-charts-to-v9.js
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
import * as pageProps from 'docsx/data/migration/migration-pickers-v8/migration-pickers-v8.md?muiMarkdown';
import * as pageProps from 'docsx/data/migration/upgrade-charts-to-v9/upgrade-charts-to-v9.md?muiMarkdown';

export default function Page() {
return <MarkdownDocs {...pageProps} />;
Expand Down
2 changes: 1 addition & 1 deletion ...ges/x/migration/migration-tree-view-v8.js → ...es/x/migration/upgrade-data-grid-to-v9.js
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
import * as pageProps from 'docsx/data/migration/migration-tree-view-v8/migration-tree-view-v8.md?muiMarkdown';
import * as pageProps from 'docsx/data/migration/upgrade-data-grid-to-v9/upgrade-data-grid-to-v9.md?muiMarkdown';

export default function Page() {
return <MarkdownDocs {...pageProps} />;
Expand Down
2 changes: 1 addition & 1 deletion .../pages/x/migration/migration-charts-v8.js → ...ages/x/migration/upgrade-pickers-to-v9.js
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
import * as pageProps from 'docsx/data/migration/migration-charts-v8/migration-charts-v8.md?muiMarkdown';
import * as pageProps from 'docsx/data/migration/upgrade-pickers-to-v9/upgrade-pickers-to-v9.md?muiMarkdown';

export default function Page() {
return <MarkdownDocs {...pageProps} />;
Expand Down
2 changes: 1 addition & 1 deletion ...ges/x/migration/migration-data-grid-v8.js → ...es/x/migration/upgrade-tree-view-to-v9.js
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
import * as pageProps from 'docsx/data/migration/migration-data-grid-v8/migration-data-grid-v8.md?muiMarkdown';
import * as pageProps from 'docsx/data/migration/upgrade-tree-view-to-v9/upgrade-tree-view-to-v9.md?muiMarkdown';

export default function Page() {
return <MarkdownDocs {...pageProps} />;
Expand Down
4 changes: 4 additions & 0 deletions docs/public/_redirects
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,4 +79,8 @@
/x/api/charts/chart-data-provider/ /x/api/charts/charts-data-provider/ 301
/x/api/charts/chart-data-provider-pro/ /x/api/charts/charts-data-provider-pro/ 301
/x/api/charts/chart-data-provider-premium/ /x/api/charts/charts-data-provider-premium/ 301
/x/migration/migration-data-grid-v8 /x/migration/upgrade-data-grid-to-v9/ 301
/x/migration/migration-pickers-v8 /x/migration/upgrade-pickers-to-v9/ 301
/x/migration/migration-charts-v8 /x/migration/upgrade-charts-to-v9/ 301
/x/migration/migration-tree-view-v8 /x/migration/upgrade-tree-view-to-v9/ 301
# Proxies
2 changes: 1 addition & 1 deletion packages/x-date-pickers/src/internals/components/PickerFieldUI.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ export const cleanFieldResponse = <
'MUI X: The `InputProps`, `inputProps`, `InputLabelProps` and `FormHelperTextProps` props are no longer supported on Picker / Field components.',
'They have been silently dropped because they would otherwise be forwarded as unknown attributes on the underlying form control.',
'Use the `slotProps` shape instead (`slotProps.input`, `slotProps.htmlInput`, `slotProps.inputLabel`, `slotProps.formHelperText`).',
'See https://mui.com/x/migration/migration-pickers-v8/#textfield-props for migration details.',
'See https://mui.com/x/migration/upgrade-pickers-to-v9/#textfield-props for migration details.',
]);
}
}
Expand Down
2 changes: 1 addition & 1 deletion packages/x-date-pickers/src/internals/hooks/useField/useField.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ export const useField = <
'MUI X: The `enableAccessibleFieldDOMStructure` prop has been removed.',
'The accessible DOM structure is now the default and only option.',
'You can safely remove the prop from your code.',
'For more information, please have a look at the migration guide (https://mui.com/x/migration/migration-pickers-v8/).',
'For more information, please have a look at the migration guide (https://mui.com/x/migration/upgrade-pickers-to-v9/).',
]);
}
}
Expand Down
3 changes: 1 addition & 2 deletions scripts/buildApiDocs/chartsSettings/index.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -137,8 +137,7 @@ export default chartsApiPages;
isGlobalClassName: isGlobalState,
nonComponentFolders: [
...getNonComponentFolders(),
'migration/migration-charts-v9',
'migration/migration-charts-v8',
'migration/upgrade-charts-to-v9',
'migration/migration-charts-v7',
'migration/migration-charts-v6',
],
Expand Down
2 changes: 1 addition & 1 deletion scripts/buildApiDocs/gridSettings/index.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ export default dataGridApiPages;
nonComponentFolders: [
...getNonComponentFolders(),
'data-grid/components/usage.md',
'migration/migration-data-grid-v8',
'migration/upgrade-data-grid-to-v9',
'migration/migration-data-grid-v7',
'migration/migration-data-grid-v6',
'migration/migration-data-grid-v5',
Expand Down
2 changes: 1 addition & 1 deletion scripts/buildApiDocs/treeViewSettings/index.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ export default treeViewApiPages;
isGlobalClassName: isGlobalState,
nonComponentFolders: [
...getNonComponentFolders(),
'migration/migration-tree-view-v8',
'migration/upgrade-tree-view-to-v9',
'migration/migration-tree-view-v7',
'migration/migration-tree-view-v6',
'migration/migration-tree-view-lab',
Expand Down
Loading