[EUI+] Reorganize+improve markdown, tables, and data grid docs

[cee-chen]

Summary

#8163

I apologize in advance for how large this PR/diff is - this PR really got away from me, for which I wholly blame datagrid 🥲

Honestly, I would probably suggest skipping code review for this one and just reviewing the end-user docs directly compared to previous iterations.

Before	After

I'm definitely looking for feedback on anything that's obviously broken in terms of functionality, or any copy/organization that feels straight up not-understandable, but as a heads up I'm likely not going to want a whole ton of large refactoring on this PR since I don't have much more time at Elastic - I'd like to get this in as before too long (given that it doesn't flagrantly break anything in prod) and continue to iterate in the future as needed.

QA

• https://eui.elastic.co/pr_8183/new-docs/docs/editors-syntax/markdown/format/
• https://eui.elastic.co/pr_8183/new-docs/docs/tabular-content/tables/
• https://eui.elastic.co/pr_8183/new-docs/docs/tabular-content/data-grid/

General checklist

N/A, docs only

[weronikaolejniczak]

Incredible changes, Cee! 🥳 🎉 Both of these categories felt messy and unintuitive, now it's easy to navigate around and the information is more granular.

I still went over the code changes cause they're quite significant. I didn't find anything that would be a blocker for this PR though. I agree that we can improve later and it'd feel wasteful for you to refactor this right now.

I tested the staging:

✅ no pages are missing
✅ no content is missing from the original pages
✅ pages follow logical order
✅ all the pages have correct slugs and <title>s
❌ some links don't work correctly (I don't mind fixing it later)

If you're busy with other things, I can push the changes to the PR and we'll have the suggestions sorted out already instead of leaving them for later. Let me know what you prefer 😄

[weronikaolejniczak]

@tkajtoch @mgadewoll @acstll I would love it if all of you went over the changes and gave your thoughts 🙏🏻

@acstll I had to resolve conflicts, and so I accepted all current changes in /basic-tables but then applied your changes from this PR, could you check if everything's as it should be?

[acstll]

@acstll I had to resolve conflicts, and so I accepted all current changes in /basic-tables but then applied your changes from this PR, could you check if everything's as it should be?

@weronikaolejniczak according to 1be312e the changes look correct 👍

(I'm actually unsure about adding responsiveBreakpoint={false} everywhere as I did, I think it's needed, but maybe there's a better (or more detailed) solution. We can look at this in the upcoming EUI+ work)

[acstll]

@weronikaolejniczak I only found one small thing! — I actually followed Cee's suggestion and went over the code rather quickly and paid more attention to the actual site 🤓

other than that this LGTM

[weronikaolejniczak]

buildkite test this

[weronikaolejniczak]

buildkite test this

[kibanamachine]

Preview staging links for this PR:

• Docs site: https://eui.elastic.co/pr_8183/
• Storybook: https://eui.elastic.co/pr_8183/storybook
• New docs: https://eui.elastic.co/pr_8183/new-docs

[elasticmachine]

💚 Build Succeeded

• Buildkite Build
• Commit: 6407d21

History

• 💔 Build elastic/eui#3446 failed ddb85d8
• 💚 Build elastic/eui#3189 succeeded 0c35e41
• 💚 Build elastic/eui#3186 succeeded bbbc124
• 💚 Build elastic/eui#3184 succeeded d8f2612
• 💔 Build elastic/eui#3179 failed 7930de3

cc @weronikaolejniczak

[cee-chen]

Thanks for getting this merged y'all!! 🎉