feat(website): add Mermaid diagram support to Docusaurus

[kennygt51]

• Add @docusaurus/theme-mermaid dependency (v3.9.2)
• Enable Mermaid configuration in docusaurus.config.ts
• Configure Mermaid theme for diagram rendering support

This enables the documentation site to render Mermaid diagrams
directly in markdown files, allowing for better visual documentation
of architecture, workflows, and system designs.

The following diagrams is examples image using Mermaid to describe relationships.

[k8s-ci-robot]

Hi @kennygt51. Thanks for your PR.

I'm waiting for a github.com member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[a-hilaly]

Not opposed to this - i can see it being used in the website.

cc @jakobmoellerdev

/approve
/ok-to-test

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: a-hilaly, kennygt51

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [a-hilaly]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[jakobmoellerdev]

please fixup the test run / finding, thanks! (you can downgrade to 3.9.1 first and then have another commit that bumps docusaurus to 3.9.2)

[kennygt51]

@jakobmoellerdev

please fixup the test run / finding, thanks! (you can downgrade to 3.9.1 first and then have another commit that bumps docusaurus to 3.9.2)

Thank you for your review.
I've fixed issue related to Docsaurs versioning.
Could you please review this PR again.

[jakobmoellerdev]

/ok-to-test

[kennygt51]

I've not execute npm install @docusaurus/[email protected] so there were some issues about npm run build. I've already fixed it.

[jakobmoellerdev]

/lgtm