Enhance documentation for Azure Optimization Engine

[Hélder Pinto (helderpinto)]

🛠️ Description

This pull request introduces documentation improvements to the FinOps toolkit, primarily by adding a comprehensive reference for the Azure Optimization Engine (AOE) and updating related documentation to reflect this addition. These changes enhance the discoverability and usability of AOE configuration details.

Documentation enhancements:

• Added a new "Reference" page (toolkit/optimization-engine/reference.md) to the AOE section in the table of contents, providing comprehensive documentation for runbooks, schedules, variables, Log Analytics tables, and SQL Database tables.
• Announced the addition of the AOE reference documentation in the changelog, highlighting its coverage of runbooks, schedules, variables, and more.
• Updated the AOE customization guide to direct users to the new reference page for a complete list of configuration variables.

Deployment fixes:

• Removed AzureOptimization_LogAnalyticsWorkspaceKey automation variable from deployment (leftover of upgrade to DCR-based ingestion) and updated variables documentation accordingly.

Changelog update:

• Updated the ms.date field in changelog.md to reflect the latest documentation update.

Fixes #1271

📋 Checklist

🔬 How did you test this change?

• 🤏 Lint tests
• 🤞 PS -WhatIf / az validate
• 👍 Manually deployed + verified
• 💪 Unit tests
• 🙌 Integration tests

📦 Deploy to test?

• Hubs + ADX (managed)
• Hubs + Fabric (manual) — URI:
• Hubs (manual)
• Hubs (no data)
• Workbooks
• Alerts

🙋‍♀️ Do any of the following that apply?

• 🚨 This is a breaking change.
• 🤏 The change is less than 20 lines of code.

📑 Did you update docs/changelog.md?

• ✅ Updated changelog (required for dev PRs)
• ➡️ Will add log in a future PR (feature branch PRs only)
• ❎ Log not needed (small/internal change)

📖 Did you update documentation?

• ✅ Public docs in docs (required for dev)
• ✅ Public docs in docs-mslearn (required for dev)
• ✅ Internal dev docs in docs-wiki (required for dev)
• ✅ Internal dev docs in src (required for dev)
• ➡️ Will add docs in a future PR (feature branch PRs only)
• ❎ Docs not needed (small/internal change)

[Copilot]

Pull request overview

This PR improves Microsoft Learn documentation for the Azure Optimization Engine (AOE) in the FinOps Toolkit by adding a dedicated reference page and wiring it into navigation and the changelog. It also includes a functional deployment template change removing a legacy Automation variable.

Changes:

• Added a new AOE “Reference” doc covering runbooks, schedules, variables, and data tables.
• Updated AOE customization guidance and the toolkit changelog/TOC to point to the new reference content.
• Removed the AzureOptimization_LogAnalyticsWorkspaceKey Automation variable from the AOE nested deployment template.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
src/optimization-engine/azuredeploy-nested.bicep	Removes a legacy Automation variable from the deployment template.
docs-mslearn/toolkit/optimization-engine/reference.md	Adds the new AOE reference documentation page.
docs-mslearn/toolkit/optimization-engine/customize.md	Links readers to the new reference page for the full variable list.
docs-mslearn/toolkit/changelog.md	Announces the new AOE reference page and updates ms.date.
docs-mslearn/TOC.yml	Adds the new reference page to the AOE documentation TOC.

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

[Brett Wilson (MSBrett)]

Two publish-facing defects need correction: the page renders with "Runbooks" as its heading instead of a reference title, and its only in-page link is broken. The remaining comments are non-blocking Microsoft style and navigation improvements.