Docusaurus v3

[fflaten]

Upgrades the docs website to Docusaurus v3 with MDX v3, prism-react-renderer v2 and React 18. Also includes some minor dependency-cleanup.

Related links:

• https://docusaurus.io/docs/next/migration/v3
• https://github.com/facebook/docusaurus/pull/8288
• https://mdxjs.com/blog/v2/
• https://mdxjs.com/migrating/v2/
• https://mdxjs.com/playground/ (Useful to verify if MDXv2-related issue/conflict)

Lessons learned during migration:

• Curly-braces outside codefences needs to be escaped as MDX v2 support JS-expressions in curlybraces. Manually fixed here to build.
  • v4 docs are static so probably fine with manual fix
  • @bravo-kernel Should the PS-module escape the rest automatically? Ex. https://github.com/pester/docs/commit/3cec780b0f8cb5c7fd2456f3d2806cff73a3e564
• MDX v2 doesn't create paragraphs for single-line content (good), but had to fix our "Required Code" <details> elements as summary-element (title) got wrapped in first paragraph.
• Legacy prefix for versioned sidebar is removed. Just need to remove version-v4.0/ from all keys and links in the json.
• prism-react-renderer API changed for theme imports and reduced default languages.

Feel free to commit to this with new builds or other fixes. Just thought we could verify early.

Fix #273

[bravo-kernel]

Thanks for creating this one. We still have some time but this makes it pretty clear what needs to be done. 👍

[bravo-kernel]

And yes, the Alt3 module should definitely be able escape the curly brackets (especially since that fix is compatible with docusaurus v2)

[bravo-kernel]

@fflaten would you be able to test the Alt3 module artifact produced in https://github.com/alt3/Docusaurus.Powershell/actions/runs/5829982515?pr=169?

If it generates the expected markdown with escaped curly brackets, I will publish a new version.

[fflaten]

No diff besides comment in sidebar. All good! 🎉

[bravo-kernel]

Thank you for testing, much appreciated. If you find anything else feel free to let me know 💃

Released in https://www.powershellgallery.com/packages/Alt3.Docusaurus.Powershell/1.0.35

[fflaten]

Great work! Will do. Hopefully not more issues to come.

[fflaten]

3.0-rc.0 adds support for TS config files. Switch or stay with JS? https://github.com/facebook/docusaurus/pull/9317

[bravo-kernel]

I have been waiting to see how they do the ts config and would (and will) personally go for it.

[fflaten]

I have been waiting to see how they do the ts config and would (and will) personally go for it.

Cool. I'll let you handle that in a separate PR 🙂

[fflaten]

Not sure if we'd like to merge this (when reviewed) or not. Feel free to close if it should be split into multiple PRs :)

[bravo-kernel]

I have no issues with merging this as it is.

I could not detect any issues in the preview so just let me know if you feel confident as well and I will merge.

[fflaten]

Nice. LGTM on my end 🙂

[bravo-kernel]

Woohoo 💃