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] Split the Editing page #7772

Open
wants to merge 6 commits into
base: v6.x
Choose a base branch
from

Conversation

cherniavskii
Copy link
Member

@cherniavskii cherniavskii commented Jan 31, 2023

Part of #7762

Changes:

  • split Editing page into multiple pages
  • move the editing recipes page to Editing -> Examples page

Preview: https://deploy-preview-7772--material-ui-x.netlify.app/x/react-data-grid/editing/

@cherniavskii cherniavskii added docs Improvements or additions to the documentation component: data grid This is the name of the generic UI component, not the React module! labels Jan 31, 2023
@mui-bot
Copy link

mui-bot commented Jan 31, 2023

Netlify deploy preview

Netlify deploy preview: https://deploy-preview-7772--material-ui-x.netlify.app/

Updated pages

These are the results for the performance tests:

Test case Unit Min Max Median Mean σ
Filter 100k rows ms 499.9 1,117.3 499.9 796.46 265.633
Sort 100k rows ms 585.8 1,154.1 585.8 893.6 191.212
Select 100k rows ms 189.4 394.7 286.7 294.36 66.653
Deselect 100k rows ms 187.3 318.6 211 241.48 50.112

Generated by 🚫 dangerJS against 42c0caa

Copy link
Member

@alexfauquette alexfauquette left a comment

Choose a reason for hiding this comment

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

Naming sounds nice. 👌

I did not read entirely the page content assuming it's copied past

I'm wondering, do you plan to add sections in "row editing" page. Otherwise, it could go to the overview page with

  • editMode="row" section between "making colums editable" and "value parser/setter"
  • CRUD example at then end

For the two other sections, they are shorts but very advanced and well-scoped, so not a problem

@@ -2,5 +2,6 @@ Broken links found by `yarn docs:link-check` that exist:

- https://mui.com/blog/material-ui-v4-is-out/#premium-themes-store-✨
- https://mui.com/size-snapshot
- https://mui.com/x/react-data-grid/editing/#row-editing
Copy link
Member

Choose a reason for hiding this comment

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

This will require an update of the material-ui repo. Especially the PricingTable.tsx

Copy link
Member Author

Choose a reason for hiding this comment

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

Yes, after releasing the v6 stable

@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged label Feb 6, 2023
@github-actions
Copy link

github-actions bot commented Feb 6, 2023

This pull request has conflicts, please resolve those before we can evaluate the pull request.

@cherniavskii
Copy link
Member Author

I'm wondering, do you plan to add sections in "row editing" page. Otherwise, it could go to the overview page with

  • editMode="row" section between "making colums editable" and "value parser/setter"
  • CRUD example at then end

The CRUD example is part of the Row editing section, so I would rather not split them.

Copy link
Member

@LukasTy LukasTy left a comment

Choose a reason for hiding this comment

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

Looks great! 💯
A similar makeover (splitting into several smaller pages) has been done to the pickers getting started page quite successfully recently. 👍

docs/data/pages.ts Show resolved Hide resolved
@MBilalShafi
Copy link
Member

MBilalShafi commented May 22, 2023

@cherniavskii Would you like to proceed with it or do you see a problem? I am trying to do a similar division of pages for Filtering.

@github-actions github-actions bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged label Jun 19, 2023
@cherniavskii
Copy link
Member Author

I've updated the PR and split the editing page again, here's the current structure: https://deploy-preview-7772--material-ui-x.netlify.app/x/react-data-grid/editing/

{ pathname: '/x/react-data-grid/editing/persistence' },
{ pathname: '/x/react-data-grid/editing/custom-edit-component' },
{ pathname: '/x/react-data-grid/editing/editing-events' },
{ pathname: '/x/react-data-grid/editing/recipes' },
Copy link
Member Author

Choose a reason for hiding this comment

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

We didn't reach an agreement on "Examples" vs "Recipes" in #7762 😅

I kept the previous title ("Recipes") for now, feel free to vote on this comment if you have a preference:

  • 🚀 for "Recipes"
  • 🎉 for "Examples"

Copy link
Member Author

Choose a reason for hiding this comment

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

@richbustos What do you think about this one?

@cherniavskii cherniavskii changed the title [DataGrid] Improve editing examples discoverability [docs] Split Editing page Jun 20, 2023
Copy link
Contributor

@richbustos richbustos left a comment

Choose a reason for hiding this comment

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

LGTM!

@cherniavskii cherniavskii changed the title [docs] Split Editing page [docs] Split the Editing page Jun 26, 2023
Copy link
Member

@MBilalShafi MBilalShafi left a comment

Choose a reason for hiding this comment

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

Nice update


<p class="description">Creating custom edit component.</p>

## Create your own edit component
Copy link
Member

Choose a reason for hiding this comment

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

Could we discard this heading in favor of the main one (i.e Custom edit component)?


<p class="description">Using editing events.</p>

## Editing events
Copy link
Member

Choose a reason for hiding this comment

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

Same with this one?

@@ -0,0 +1,59 @@
# Data Grid - Editing Persistence
Copy link
Member

Choose a reason for hiding this comment

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

Since we only cover server-side persistence on this page, would it be better to call it Server-side persistence and discard the extra heading (i.e. Server-side persistence), or we plan to extend it with the other topics which fall under persistence?

@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged label Jul 14, 2023
@github-actions
Copy link

This pull request has conflicts, please resolve those before we can evaluate the pull request.

Copy link
Member

@joserodolfofreitas joserodolfofreitas left a comment

Choose a reason for hiding this comment

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

Bumping this awesome update.

@MBilalShafi MBilalShafi changed the base branch from master to v6.x March 21, 2024 02:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component: data grid This is the name of the generic UI component, not the React module! docs Improvements or additions to the documentation PR: out-of-date The pull request has merge conflicts and can't be merged
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

8 participants