[Automated][azure-resource-manager][skip chg] Update Azure Resource Manager documentation

[Mark Cowlishaw (markcowl)]

No description provided.

[github-actions]

All changed packages have been documented.

• ✅ @azure-tools/typespec-azure-resource-manager

Show changes

@azure-tools/typespec-azure-resource-manager - internal ✏️

Update Azure Resource Manager documentation with guidance for relationship base types and related resource definitions.

[github-actions]

📦 Package size report

✅ No notable package size changes compared to the base branch.

13 package(s) with no notable change

Package	Packed (base → head)	Δ Packed	Unpacked (base → head)	Δ Unpacked
@azure-tools/typespec-java	13.51 MB → 13.51 MB	-110 B (-0.0%)	15.03 MB → 15.03 MB	—
@azure-tools/typespec-azure-resource-manager	176.22 KB → 176.22 KB	+7 B (+0.0%)	1.07 MB → 1.07 MB	+9 B (+0.0%)
@azure-tools/azure-http-specs	146.76 KB → 146.76 KB	—	1.16 MB → 1.16 MB	—
@azure-tools/typespec-autorest	81.23 KB → 81.23 KB	—	396.61 KB → 396.61 KB	—
@azure-tools/typespec-autorest-canonical	7.42 KB → 7.42 KB	—	26.00 KB → 26.00 KB	—
@azure-tools/typespec-azure-core	130.84 KB → 130.84 KB	—	709.84 KB → 709.84 KB	—
@azure-tools/typespec-azure-portal-core	42.46 KB → 42.46 KB	—	193.15 KB → 193.15 KB	—
@azure-tools/typespec-azure-rulesets	5.28 KB → 5.28 KB	—	33.16 KB → 33.16 KB	—
@azure-tools/typespec-client-generator-core	237.09 KB → 237.09 KB	—	1.27 MB → 1.27 MB	—
@azure-tools/typespec-go	261.39 KB → 261.39 KB	—	1.34 MB → 1.34 MB	—
@azure-tools/typespec-metadata	15.91 KB → 15.91 KB	—	62.26 KB → 62.26 KB	—
@azure-tools/typespec-python	42.22 KB → 42.22 KB	—	164.91 KB → 164.91 KB	—
@azure-tools/typespec-ts	540.59 KB → 540.59 KB	—	2.60 MB → 2.60 MB	—

_{Packed = gzipped .tgz published to npm. Unpacked = total extracted size. 🆕 added, 🗑️ removed. Packages from the core/ submodule are not included.
🔴 grew · 🟢 shrank — only changes of at least 512 B and 0.5% are marked.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@azure-tools/typespec-azure-resource-manager@5355

commit: eb99d02

[azure-sdk-automation]

You can try these changes here

🛝 Playground	🌐 Website

[Mark Cowlishaw (markcowl)]

Copilot Pull the latest from main, add descriptive changesets for any packages changed in this pr (typespec-azure-resource-manager only, I think). Make the suggested changes, regenerate documentation, ensure that all tests pass, all changed files are correctly formatted and only the changes associated with this pr are in the pr diff/

[Mark Cowlishaw (markcowl)]

Copilot, you will also have to regenerate samples to ensure that any documentation changes are picked up there

[Copilot]

Copilot Pull the latest from main, add descriptive changesets for any packages changed in this pr (typespec-azure-resource-manager only, I think). Make the suggested changes, regenerate documentati...

Pulled latest main, applied the relationship documentation suggestions, added a descriptive changeset for @azure-tools/typespec-azure-resource-manager, regenerated the ARM reference docs, and verified formatting, lint, and all 381 ARM tests. Changes are in commit 9dba96f.

[Mark Cowlishaw (markcowl)]

Copilot you need to regenerate the samples to get the ci to pass - the documentation change you created shows up in the openapi output from the samples.

[Copilot]

Copilot, you will also have to regenerate samples to ensure that any documentation changes are picked up there

Regenerated the sample snapshots; the resulting ARM OpenAPI output is in commit c5b5c1b.

Copilot you need to regenerate the samples to get the ci to pass - the documentation change you created shows up in the openapi output from the samples.

Regenerated the samples and updated the generated ARM OpenAPI description in commit c5b5c1b; the sample test passes.