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] Add App starters in related-projects.md #44315

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

oliviertassinari
Copy link
Member

@oliviertassinari oliviertassinari commented Nov 3, 2024

@oliviertassinari oliviertassinari added the docs Improvements or additions to the documentation label Nov 3, 2024
@@ -7,63 +7,74 @@ Developers from the community have built some excellent supplemental tools for w
Do you have a project that you think should be featured here?
Feel free to submit a pull request and the maintainers will work with you to write the description.

## Premium tools
Copy link
Member Author

Choose a reason for hiding this comment

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

Showing paid content first felt backward.

@@ -7,63 +7,74 @@ Developers from the community have built some excellent supplemental tools for w
Do you have a project that you think should be featured here?
Feel free to submit a pull request and the maintainers will work with you to write the description.

## Premium tools
## App starters
Copy link
Member Author

Choose a reason for hiding this comment

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

I guess we can group those under this category.

Copy link
Member Author

@oliviertassinari oliviertassinari Nov 3, 2024

Choose a reason for hiding this comment

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

Now, if we subscribe to this view: #40062 (comment), this content is wrong here we should move it under a new "Examples project page".

Copy link
Contributor

Choose a reason for hiding this comment

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

Alternative titles:

  • Third-party scaffolds
  • Third-party framework integrations

I think it's important to make it clear that we don't maintain anything on this page.

- [formik-material-ui](https://github.com/stackworx/formik-mui): Bindings for using Material UI with [formik](https://formik.org/).
- [mui-rff](https://github.com/lookfirst/mui-rff): Bindings for using Material UI with [React Final Form](https://final-form.org/react).
- [@ui-schema/ds-material](https://www.npmjs.com/package/@ui-schema/ds-material) Bindings for using Material UI with [UI Schema](https://github.com/ui-schema/ui-schema). JSON Schema compatible.
- [@data-driven-forms/mui-component-mapper](https://www.data-driven-forms.org/provided-mappers/mui-component-mapper): Bindings for using Material UI with [Data Driven Forms](https://github.com/data-driven-forms/react-forms).
Copy link
Member Author

Choose a reason for hiding this comment

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

Outdated

Comment on lines -39 to +37
#### Layout
### Layout
Copy link
Member Author

@oliviertassinari oliviertassinari Nov 3, 2024

Choose a reason for hiding this comment

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

So we can anchor links them in the search, if I search for a rich text editor in Algolia, I want to land on the header.
Also so this can be shared with teammates.
And so we can skim-read with the TOC.

Today, those lists are a bit skinning but there should be more content here. Not having more is only an indicator that Material UI is failing, there used to be more. Shacn UI / Bootstrap have more.


- [mui-tiptap](https://github.com/sjdemartini/mui-tiptap): A customizable Material UI-styled WYSIWYG rich text editor, built with [Tiptap](https://tiptap.dev/).

### Form
Copy link
Member Author

Choose a reason for hiding this comment

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

I guess we might want to duplicate the content?

## Complementary projects
## Supplementary projects
Copy link
Member Author

Choose a reason for hiding this comment

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

Sync with the new header used by Sam in #44191. I guess it makes more sense https://ell.stackexchange.com/questions/188457/difference-between-complementary-and-supplementary.

## Third-party integrations
## Supplementary components
Copy link
Member Author

Choose a reason for hiding this comment

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

Seems to match the other sections. It's not even an integration anyway notistack copies the style but doesn't depend on Material UI.

@oliviertassinari oliviertassinari changed the title [docs] App starters [docs] Add App starters in related-projects.md Nov 3, 2024

### Notification

- [notistack](https://github.com/iamhosseindhv/notistack): Makes it easy to display snackbars (so you don't have to deal with open/close state of them).
Copy link
Contributor

Choose a reason for hiding this comment

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

Nitpick: here's how I'd phrase this

Suggested change
- [notistack](https://github.com/iamhosseindhv/notistack): Makes it easy to display snackbars (so you don't have to deal with open/close state of them).
- [notistack](https://github.com/iamhosseindhv/notistack): Display multiple snackbars that can be stacked and queued—this tool makes it simpler to handle the open and close states.

@@ -7,63 +7,74 @@ Developers from the community have built some excellent supplemental tools for w
Do you have a project that you think should be featured here?
Feel free to submit a pull request and the maintainers will work with you to write the description.

## Premium tools
## App starters
Copy link
Contributor

Choose a reason for hiding this comment

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

Alternative titles:

  • Third-party scaffolds
  • Third-party framework integrations

I think it's important to make it clear that we don't maintain anything on this page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to the documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants