RDoc-4094 Cloud docs update for the September 2026 deployment

[PFYasu]

Documents the user-facing changes in the September deployment window.
Ticket: https://issues.ravendb.net/issue/RDoc-4094

Alerts

• New Alerts section in Maintenance & Troubleshooting: daily summary vs. custom alerts, subscribers, the per-product limits (25 rules, 20 recipients, one daily summary) and the four cases where rules are removed automatically — including a last-recipient removal deleting the whole rule.
• Trigger events point at the existing Labels table rather than restating them, since that table already carries the thresholds.
• Short generic View the Alerts section on the Products page, following the Metrics / Cluster Health pattern (generic in the Portal pages, detail outside).

Billing & Costs

• Current billing period costs donut, the Unbilled total and the Cost Details entry points.
• Spending: the cost-category filter (all 18 categories), the year-picker behaviour and the "not calculated yet" states.
• New Cost details section for /billing/cost-details, which was previously undocumented, including the prediction caveat on unbilled periods and the marketplace notices.

Portal navigation

Rewrote the Portal overview for the collapsible sidebar: the seven role-gated views, the Help center menu (Support, Documentation, Community, Service status) and the profile entry. Support and Service status are no longer top-level entries. Added the missing Users & Access entry, and noted that the account switcher identifies accounts by domain name.

Support

Request support for this instance from the product view (paid support only, pre-selects the product), plus the support resources panel on the product view.

Login

Google, GitHub and Microsoft sign-in, with each provider's email-verification requirement. Microsoft work/school (Entra ID) accounts additionally need the tenant to attest domain ownership via the xms_edov optional claim — worth calling out, because a tenant that does not emit it fails with "could not be verified" even though the address is correct. Also lists the actual sign-in failure messages.

Provisioning

Noted that the Account and Billing wizard stages are skipped when the account already has those details, and are never shown for marketplace accounts — so the documented five-stage flow is the first-product case.

---

Second pass — validated against hr/test

Every claim below was checked against the cloud portal source rather than inferred, and the whole set was re-validated after the September merge landed on hr/test.

Autoscaling — rewritten (RDBCL-3989)

RDBCL-3989 replaced the flat CPU thresholds with three independent metrics: load average, available memory and IO wait, each with its own low/high limit and duration. The old section described CPU only, and 4 of its 10 table rows no longer exist in the UI.

• Separate Upscaling and Downscaling tables, each row carrying the UI's enforced min/max from autoscalingThresholdFields.ts.
• New Autoscaling range subsection for lowest/highest type.
• Admonition on the asymmetry the code comments call out: downscaling watches the low load average and low IO wait but the high available memory, because available memory runs opposite to utilisation.
• New Serverless Autoscaling subsection — the one ProductFeatureName value that had no coverage. Always enabled (canDisableFeature={false}), and its modal exposes only the instance range; the thresholds are managed for you.

Automatic Storage Extension — corrected

• The threshold range is 70–95, not 0–100. The <input> carries min=0 max=100, but both UpdateThresholdSchema.ts (Yup.number().min(70).max(95)) and ProductValidator.cs enforce 70–95. Entering 50 was rejected with no explanation in the docs.
• Two gating rules were undocumented (ModelExtensions.cs): the product must be Active, and the threshold cannot be changed at all on yearly contracts.
• The setting is disk usage, not memory — the old wording came from a screenshot predating the Memory Used Threshold → Disk Space Used Threshold rename.

Products tab — restructured

• Security and Allowed IPs split into separate sections; they are separate cards and are not adjacent in the UI.
• Documented the Certificate expiration date card (RDBCL-4473) and the renewal schedule behind it: certificates are issued for 5 years, a renewal email goes out at 60 days, and automatic regeneration happens at 30 days (Constants.Certificate, ProvisionProductCommandHandler).
• Instance Access rewritten — ProductEditAccessSection is dead code on hr/test; Open Studio moved to the product-details top bar and becomes a per-node dropdown on multi-node products, so "opens the Studio of node A" was wrong for clusters.
• New Subscription & support section (RDBCL-5326): subscription details, the Update available release-channel pill, the marketplace guard, and the Support-role gating on the badge and CTA.
• Section order now follows the UI, and figure numbering was reconciled.

Support — response times and the skipped step

• The response-time admonition stated two conditions; the code has three. Severity is the dominant gate and was entirely undocumented: Within 2 hours additionally requires severity === "Critical", Next business day requires Normal or Critical. A paying customer filing a Minor issue finds both greyed out. Replaced with a per-option condition table.
• The tier restriction applies only to product-related questions — a general question is never tier-blocked.
• Both step lists were missing a mandatory step: the Resources that may help you panel gates the rest of the form via isFamiliarWithResources, so the Expected Response Time section does not render until you click through it. Lists are now 7 and 10 steps, using the UI's own field labels.

Backup

The mandatory backup is a Server-Wide Backup (BackupHelper takes a ServerWideBackupConfiguration), so it covers every database rather than being per-database. The navigation said "Manage Ongoing Tasks"; the view is Ongoing Tasks.

Link and alt-text hygiene

• 10 broken in-page anchors fixed across cloud/ — verified old-broken / new-valid against the rendered HTML, not guessed slugs.
• 152 image tags normalised. !["Figure N - X"](…) put the literal quotes inside the alt attribute (alt=""…""), which screen readers announce. The Figure N prefixes were invisible (LazyImage renders no caption) and referenced by no prose, while costing renumbering on every insertion. Now ![X](…). Also repaired a malformed tag in cloud-aws-marketplace.mdx that was missing its closing quote.

---

Before merge

• cloud/portal/assets/portal-product-alerts.png is a placeholder. Component-level capture with no portal chrome, so it does not match the framing of the neighbouring Metrics / Cluster Health figures. Needs a real-portal shot (sidebar + product header + Alerts tab active).
• Sections still without figures: Cost details, the Alerts subsections in Maintenance & Troubleshooting, and Serverless Autoscaling.
• Stale figures: portal-billing-costs-tab-current-billing-period.png still shows the 3% marketplace commission notice removed by RDBCL-4746; portal-billing-costs-tab-billing-history.png predates two column reworks (RDBCL-4739, RDBCL-4751). SNMPv3 Monitoring credentials has no figure while its sibling does.
• Terminology. The prose describes a sidebar and calls them "views", while the eight portal page titles and filenames still say "Tab". Renaming needs scripts/redirects.json entries, so it is out of scope here.

⚠️ Deploy ordering

Two features documented here are on hr/test but not on hr/prod:

Feature	hr/test	hr/prod
Autoscaling metrics (RDBCL-3989)	yes	no
"Sign in with Microsoft" (RDBCL-5283)	yes	no

Correct for the September deployment; wrong if this merges before that ships. Please check the deploy order before merging.

Noted while working, not fixed here

#manage-product-the-security-tab does not exist on the products tab page — the anchor is #security-your-certificate-audit-logs-and-allowed-ips. Three guides still point at the old one and land at the top of the page:

• guides/connecting-c-application-to-ravendb-cloud.mdx
• guides/connecting-node-js-application-to-ravendb-cloud.mdx
• guides/how-to-setup-ravendb-with-asp-net-core-8-application.mdx

(The previously-noted #cloud-account-portal-products from cloud/cloud-migration.mdx is fixed in this PR.)

Docusaurus validates page links but not anchors, which is why the build stays green either way.

Also still unreferenced: cloud/assets/portal-product-details-storage-upgrade-to-premium-v2.png, a duplicate of the portal/assets copy, orphaned before this work.

Verified with npm run build:current — clean, no warnings, no broken links.