docs: reflect real-world hub cost estimate ranges

[Michael Flanakin (flanakin)]

🛠️ Description

Updates the FinOps hubs cost estimate note to reflect real-world Azure Data Explorer and Microsoft Fabric pricing and calls out that Data Explorer cost varies significantly by region. Addresses the gap reported in #2229 (and previously #1719): the flat $120/$300 baseline understated actual cost for some regions and SKUs.

Fixes #2229

📷 Screenshots

Not applicable — text-only change to an existing note, no visual/UI change.

📋 Checklist

🔬 How did you test this change?

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

Docs-only change — no build or deploy impact. Lint suite passes (3585/3585, includes the ms.date/frontmatter checks for docs-mslearn).

📦 Deploy to test?

Not applicable — no src/templates changes.

🙋‍♀️ 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)

This PR is the doc update — docs-mslearn/toolkit/hubs/finops-hubs-overview.md.

🤖 Generated with Claude Code

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Roland Krummenacher (RolandKrummenacher)]

Agreed the old figures were understated — thanks for picking up #2229. Two things before this lands.

This is one of four surfaces carrying these numbers, and the other three still say $120/$300/$5. Notably including the portal deploy UI, which is where most customers actually encounter the estimate:

• src/templates/finops-hub/createUiDefinition.json — line 97 ($120/mo for ADX), line 117 ($300/mo for F2), line 244 (~$5/mo per million), line 289, and the worked example on line 577 ($250/mo). None are in this diff.
• docs-mslearn/toolkit/power-bi/help-me-choose.md:52 — comparison table still reads Starts at $120 + ~$10 per $1M, Starts at $300, and ~$3-5 per $1M.
• docs/deploy/finops-hub-latest.ui.json — generated, so it follows once createUiDefinition.json is updated.

As it stands the docs and the deployment experience would quote different headline costs for the same thing.

The $15 figure contradicts the $10 in the same sentence — inline below.

Also worth confirming the calculator behind https://aka.ms/finops/hubs/calculator was refreshed, since the note sends people there for the detail.

[Roland Krummenacher (RolandKrummenacher)]

Re-reviewed at b4e679e. Since the 2026-08-28 review the branch has picked up a changelog entry, a merge from dev, and two ms.date bot commits — none of the review feedback is addressed yet, so both open threads still stand and I've left them open.

1. The $10 / $15 contradiction is still there. Lines 28 and 30 of finops-hubs-overview.md currently read:

Starts at $160/mo + $10/mo per $1M in cost being monitored.

... plus $10 in Azure storage and processing cost per $1M being monitored. ... Cost without Data Explorer or Fabric is $15 per $1M.

The no-Data-Explorer deployment still comes out more expensive per $1M than the Data Explorer deployment's incremental. Whichever of $10/$15 is correct, the other two occurrences need to move with it.

2. The other three surfaces still carry the old figures. Verified at the PR head:

• src/templates/finops-hub/createUiDefinition.json — L97 $120/mo, L117 $300/mo, L244 ~$5/mo per million, L289 $120/mo + ~$5/mo, L577 worked example $250/mo.
• docs-mslearn/toolkit/power-bi/help-me-choose.md:52 — Starts at $120 + ~$10 per $1M, Starts at $300, ~$3-5 per $1M.
• docs/deploy/finops-hub-latest.ui.json — same five strings (generated; follows once createUiDefinition.json is updated).

The portal deploy UI is where most customers actually see the estimate, so shipping this doc change alone would leave the docs and the deployment experience quoting different headline costs for the same thing.

3. Nit still open: dropping (we estimate ~20GB per $1M) removes the only handle a reader has for sanity-checking against their own data volume. Could it stay alongside the new "region" caveat rather than being swapped for it?

---

New since the last review

• The changelog entry itself looks good — right section (FinOps hubs → Changed), correct issue link, sentence casing.
• docs-mslearn/toolkit/changelog.md now conflicts with dev (ms.date and the Changed list — the usual additive pattern). Per AGENTS.md: merge origin/dev in, keep both sides' entries, and set ms.date to the merge date rather than either side's value.
• Still worth confirming the calculator behind https://aka.ms/finops/hubs/calculator was refreshed, since the note sends people there for the detail.

[Michael Flanakin (flanakin)]

🤖 [AI][Claude Code] ✅ Implemented

Addressed both open threads plus the scope-expansion point from the general review comment:

• $10/$15 contradiction (lines 28, 30): reverted the no-Data-Explorer/Fabric figure from $15 back to its original $5 per $1M, restoring the coherent pairing with the unchanged $10/$1M with-ADX headline. The $160/$310 baseline bump and region caveat are unchanged.
• (we estimate ~20GB per $1M) nit: restored alongside the new region caveat rather than dropping it.
• The other three surfaces: updated src/templates/finops-hub/createUiDefinition.json, the generated docs/deploy/finops-hub-latest.ui.json, and docs-mslearn/toolkit/power-bi/help-me-choose.md's comparison table to the same $160/$310 figures, including a region-variance note on the Data Explorer copy in the portal UI. All four surfaces are now consistent.

Not addressed — outside what I can verify from here: whether the calculator behind https://aka.ms/finops/hubs/calculator reflects these updated figures. Flagging for manual confirmation before merge.

Full lint suite passes (3585/3585).

[Michael Flanakin (flanakin)]

🤖 [AI][Claude Code] PR Update Summary

Addressed: 2 thread(s) + 1 general review comment

• ✅ Implemented: 3 (the $10/$15 contradiction, the ~20GB hint nit, and the 4-surface consistency fix)

Reconciled the hub cost estimate note so all four surfaces (docs-mslearn overview, help-me-choose.md comparison table, portal deploy UI, and its generated ui.json) consistently show $160/mo (Data Explorer) and $310/mo (Fabric F2), with $10/$1M incremental and $5/$1M baseline. Lint suite passes 3585/3585.

[Roland Krummenacher (RolandKrummenacher)]

Approving — both of my earlier points are addressed. The $15 is back to $5 (restoring the coherent $10-with-ADX / $5-without pairing), the ~20GB per $1M hint is retained alongside the region caveat, and the other surfaces are updated: createUiDefinition.json lines 97/117/289/577 and help-me-choose.md:52. The worked example arithmetic checks out ($290 = $160 + $10 × 13).

Non-blocking, in rough priority order:

The SKU dropdown right below the changed text still quotes the old prices. createUiDefinition.json labels the SKUs ~$110/mo / ~$121/mo (lines 296/306) and ~$245/mo (line 310). The blade now reads "Added cost: Starts at $160/mo (varies by region)" directly above a default SKU labeled "(~$121/mo)" — the old $120 headline lined up with that label, and raising it broke the pairing. Note defaultValue matches by label, so 296 and 306 have to change together. Same origin in main.bicep:57 and modules/hub.bicep:74-75.

$310 isn't a "starts at" floor for Fabric. From the live retail prices, F2 (2 CU) ranges from $262.80/mo in East US to $452.60/mo in South Africa West / Norway West, median $306.60 — 31 of 54 regions are below $310. It's the median rather than the floor. Fabric also varies more by region (1.7x) than Data Explorer, yet the "varies by region" caveat was only added to the Data Explorer text. Still an improvement on $300, so not worth holding.

Two surfaces still carry $120 that weren't in my original list: docs/hubs.md:62 (the Jekyll site) and the agent plugin — SKILL.md:110, README.md:72, references/finops-hubs-deployment.md:20. The plugin ones are LLM grounding text, so an installed plugin will answer with the exact figure #2229 flagged as understated.

Minor: docs/deploy/finops-hub-latest.ui.json is generated — Package-Toolkit.ps1:156 copies it straight from createUiDefinition.json. Harmless here since both were edited identically; it just puts v15 pricing on the v14 Deploy-to-Azure link ahead of the release.

Branch needs a merge from dev before it can land.

[Roland Krummenacher (RolandKrummenacher)]

Adding the inline anchors for the points from my approval above — all non-blocking, the approval stands.

[Roland Krummenacher (RolandKrummenacher)]

Follow-on from this line (non-blocking): the SKU dropdown just below still quotes the old prices — ~$110/mo and ~$121/mo at lines 296 and 306, ~$245/mo at line 310. The blade now reads "Added cost: Starts at $160/mo (varies by region)" directly above a default SKU labeled "(~$121/mo)". The old $120 headline lined up with that ~$121 label, so raising the headline is what broke the pairing.

Note defaultValue matches by label, so 296 and 306 have to be edited together. The same figures originate in main.bicep:57 and modules/hub.bicep:74-75, which are also unchanged.

[Roland Krummenacher (RolandKrummenacher)]

Non-blocking, on $310 for F2 Fabric capacity presented as a "starts at" floor: I pulled the live retail prices for F2 (2 CU) and it ranges from $262.80/mo (East US and other cheap regions) to $452.60/mo (South Africa West, Norway West), median $306.60 — 31 of 54 regions are below $310. So $310 is roughly the median rather than a floor.

Also worth noting: Fabric varies more by region (1.7x spread) than Data Explorer does, yet the new region caveat was only added to the Data Explorer half of the sentence. Still an improvement on $300, so not worth holding the PR.

[Roland Krummenacher (RolandKrummenacher)]

Same point as on finops-hubs-overview.md: Starts at $310 is closer to the median F2 price than to a floor (measured range $262.80-$452.60/mo across 54 regions). Non-blocking — flagging it here too since this table is the one people compare options with.

[Roland Krummenacher (RolandKrummenacher)]

Minor: this file is generated — Package-Toolkit.ps1:156 copies it straight from src/templates/finops-hub/createUiDefinition.json at package time, and the last three PRs touching createUiDefinition.json left docs/deploy alone.

No harm here since both sides were edited identically, so the src edit alone would have sufficed. The one real effect is that the v14 Deploy-to-Azure link now shows v15 pricing text ahead of the release — fine if that's intended, since prices apply to v14 too.

[Michael Flanakin (flanakin)]

🤖 [AI][Claude Code] PR Update Summary

Reverted the headline $120→$160 / $300→$310 cost changes back to the original figures after closer research showed the real-world dev/test SKU baseline (~$115-135/mo) is already close to $120. Kept the Data Explorer SKU dropdown price corrections since those are independently accurate. Posted a comment on #2229 asking the reporter to confirm what they were seeing, and moved this PR + the issue to milestone v16 pending that answer.

Lint suite passes 3585/3585; JSON and Bicep validate.