Prepare for docusaurus v3

[pepopowitz]

Docusaurus v3 is now in beta and the official release is around the corner. This is the perfect time to start preparing your site for this new major version.

https://docusaurus.io/blog/preparing-your-site-for-docusaurus-v3

There is anecdotal data from the write-the-docs slack that performance is improved in v3.

[akeller]

I saw they anticipate releasing V3 in the next few days unless something big comes up.

[akeller]

I'm glad to see they acknowledged the MDX upgrade and infrastructure changes were the bulk of this release.

I did see two interesting features highlighted:

• Unlisted content
• Code blocks

I don't know how much we'll be able to do with code blocks, but I'm a sucker for interactive experiences.

I didn't realize draft:true was already available for docs and pages (I thought this was a blog only feature). This and the unlisted:true option could help us with some of the feedback that came up in retros around proactive docs authoring or reviewing content without running it locally. CC @christinaausley

☝ I'll create two issues for the draft and unlisted content, respectively. I'd like to see us incorporate a strategy for using the draft feature and then when we move to V3, a strategy for using unlisted.

[akeller]

This came up during our 8.4 docs retro as a possible idea to explore to keep our build times down.