docs(Modal): add storybook MDX example

[emyarod]

Ref #6591

This PR adds a custom modal state manager example and MDX docs to the existing Modal docs

Testing / Reviewing

Review the new modal state manager example and the storybook Docs tabs updates

[netlify]

Deploy preview for carbon-elements ready!

Built with commit 5791197

https://deploy-preview-6804--carbon-elements.netlify.app

[netlify]

Deploy preview for carbon-components-react ready!

Built with commit 5791197

https://deploy-preview-6804--carbon-components-react.netlify.app

[joshblack]

@emyarod looking through the Modal PRs, would it make sense if we consolidate them into a single docs page and maybe grouped them under a "Modal" group? Just saw some of the content here included ComposedModal which made me think of it 👀

[emyarod]

yeah that's a side effect of moving from the website to storybook where we have distinct exported components. so would that mean grouping the stories together or something?

[tw15egan]

Could you do something like (in ComposedModal-story.js) import mdx from '../Modal/Modal.mdx' ? Basically just reference the same MDX files in each of them.

Haven't tested so not sure it's possible.

[emyarod]

yeah we can do that if we are fine with combining the docs for the modal variants, but the component previews will all be the same as well

[joshblack]

I think we could definitely do a Modal group and group each sub-component under it while providing a holistic "how to use modal" docs page. The other option could be that we each docs page refer to only the component in the story (e.g. Modal.mdx would only talk about Modal).

For data table, I ended up doing the former but I can see value either way 👍

[emyarod]

yeah I can make the ComposedModal docs more scoped to ComposedModal usage. there will be some overlap at the end of the day though since they are both modals

[tw15egan]

This is an awesome addition to the Modal documentation! Very thorough and will really help or users when dealing with this component. Thanks for taking the time to explain some of the more complicated areas of this component.

The only changes I have are some formatting changes to fit better with our other mdx files, better syntax highlighting, and a few wording changes (feel free to ignore those, though!). I like the usage of the InlineNotification, we just need to import it into the mdx file 👍

[joshblack]

Looks good with TJ's review comments above 👀 Let me know when they're addressed and I can re-review!

[tw15egan]

Just a few tiny comments, other than that it looks 💯