Path to Docusaurus 3

[akeller]

Description

This is my mess. You can join me here, or tackle things piecemeal. Related to #2719.

When should this change go live?

• This is a bug fix, security concern, or something that needs urgent release support.
• This is already available but undocumented and should be released within a week.
• This on a specific schedule and the assignee will coordinate a release with the DevEx team. (apply hold label or convert to draft PR)
• This is part of a scheduled alpha or minor. (apply alpha or minor label)
• There is no urgency with this change and can be released at any time.

PR Checklist

• My changes are for an already released minor and are in /versioned_docs directory.
• My changes are for the next minor and are in /docs directory (aka /next/).

• My changes require an Engineering review, and I've assigned the Engineering DRI or delegate.
• My changes require a technical writer review, and I've assigned @camunda/tech-writers as a reviewer.

[github-actions]

👋 🤖 🤔 Hello! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.6/.

• docs/self-managed/modeler/web-modeler/configuration/configuration.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

[akeller]

In the API spec .mdx files, it looks like <div>'s are opened but not closed.

Error: MDX compilation failed for file "/Users/amara/Projects/post-86/camunda-docs/versioned_docs/version-8.6/apis-tools/zeebe-api-rest/specifications/unassign-a-user-task.api.mdx"
Cause: Expected a closing tag for <div> (39:548-39:553) before the end of paragraph
Details:
{
"column": 1,
"message": "Expected a closing tag for <div> (39:548-39:553) before the end of paragraph",
"line": 39,
"name": "39:1-39:553",
"place": {
"start": {
"line": 39,
"column": 1,
"offset": 2630,
"_index": 0,
"_bufferIndex": 0
},
"end": {
"line": 39,
"column": 553,
"offset": 3182,
"_index": 1,
"_bufferIndex": -1
}
},
"reason": "Expected a closing tag for <div> (39:548-39:553) before the end of paragraph",
"ruleId": "end-tag-mismatch",
"source": "mdast-util-mdx-jsx"
}

[akeller]

Apparently, prettier went to the past...

[akeller]

The deploy tag produces a different issue, the version of Node is old. That's not what I get on my local machine, instead I experience this:

Screen.Recording.2024-11-06.at.2.17.17.PM.mov