Aks the easy way refresh

[pauldotyu]

Purpose

This pull request introduces significant improvements to the AKS lab automation assets, Docusaurus documentation configuration, and project dependencies. The main highlights are the addition of a comprehensive Azure deployment template for lab resources, enhanced documentation support for Mermaid diagrams, and dependency updates to the latest Docusaurus version.

Azure Deployment Template and Lab Automation:

• Added a full-featured main.bicep and corresponding main.json ARM template in docs/getting-started/aks-automatic/assets/ to automate the provisioning of resources required for AKS labs, including Log Analytics, Prometheus, App Insights, Container Registry, Key Vault (with RBAC and role assignments), Managed Identity, and Azure OpenAI with a GPT-5.4-mini deployment. The templates also define outputs for downstream use. [1] [2]
• Introduced a new .github/agents/lab-qa-reviewer.agent.md agent definition that provides detailed instructions for validating lab content, including step-by-step execution, accessibility checks, and structured reporting.

Documentation and Tooling Enhancements:

• Enabled Mermaid diagram support in Docusaurus by updating docusaurus.config.ts to include the @docusaurus/theme-mermaid theme and related markdown options.
• Updated project dependencies to Docusaurus 3.10.0 (core, preset-classic, plugin-google-gtag, theme-mermaid, and dev tools), ensuring compatibility and access to the latest features and bug fixes. [1] [2]

Does this introduce a breaking change?

[x] Yes - update to Docusaurus 3.10
[ ] No

Pull Request Type

What kind of change does this Pull Request introduce?

[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[x] Refactoring (no functional changes, no api changes)
[x] Documentation content changes
[ ] Other... Please describe:
```-- Add any other helpful information that may be needed here. -->

[Copilot]

Pull request overview

This PR refreshes the “AKS the Easy Way / AKS Automatic” workshop experience by updating the Docusaurus site tooling (including Mermaid support), adding new lab automation templates (Bicep + ARM JSON), and reorganizing/rewriting the AKS Automatic workshop content.

Changes:

• Upgraded Docusaurus dependencies to 3.10.0 and added @docusaurus/theme-mermaid.
• Enabled Mermaid rendering in Docusaurus and introduced a new, expanded AKS Automatic workshop doc (moved into a folder with assets).
• Added new Azure deployment templates (main.bicep + compiled main.json) to provision lab prerequisite resources, plus a new lab QA agent definition.

Reviewed changes

Copilot reviewed 7 out of 149 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
package.json	Bumps Docusaurus packages to 3.10.0 and adds Mermaid theme dependency.
docusaurus.config.ts	Enables Mermaid support and adjusts markdown/broken-link settings.
docs/getting-started/aks-automatic/assets/main.bicep	Adds a Bicep template to provision lab prerequisite Azure resources and outputs.
docs/getting-started/aks-automatic/assets/main.json	Adds the compiled ARM JSON template equivalent of main.bicep.
docs/getting-started/aks-automatic/aks-automatic.mdx	Adds the refreshed AKS Automatic workshop content (including Mermaid diagram).
docs/getting-started/aks-automatic.mdx	Removes the previous AKS Automatic workshop doc at the old location.
.github/agents/lab-qa-reviewer.agent.md	Adds a reusable agent definition for end-to-end lab QA validation.