Add azure-mgmt-unified-design.md: TypedDict-driven Azure management SDK design document

[Copilot]

Description

Adds a design document showcasing a lightweight unified Azure management SDK approach using Python's TypedDict for declarative resource specifications with automated CRUD/paging/LRO operation mapping.

Document contents:

• TypedDict meta-definitions: ResourceSpec, OperationSpec, PagingSpec, LROSpec, CRUDSpec, ParameterSpec
• Example resource specs for VirtualMachine and StorageAccount
• AutoResourceManager base class implementation with automatic operation generation
• ResourceManagerFactory for resource registration and access
• Practical usage examples

Key pattern:

VIRTUAL_MACHINE_SPEC: ResourceSpec = {
    "name": "VirtualMachine",
    "provider_namespace": "Microsoft.Compute",
    "resource_type": "virtualMachines",
    "api_version": "2024-07-01",
    "crud": {"get": True, "create_or_update": True, "delete": True, "list": True},
    "paging": {"item_name": "value", "next_link_name": "nextLink"},
    "lro": {"polling_method": "azure-async-operation", "polling_interval": 30},
}

Location: doc/dev/mgmt/azure-mgmt-unified-design.md

All SDK Contribution checklist:

• The pull request does not introduce [breaking changes]
• CHANGELOG is updated for new features, bug fixes or other significant changes.
• I have read the contribution guidelines.

General Guidelines and Best Practices

• Title of the pull request is clear and informative.
• There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

• Pull request includes test coverage for the included changes.

N/A - documentation only, no executable code changes.

Original prompt

Create a Gist for the lightweight unified Azure management SDK design, featuring TypedDict meta-definitions for automated CRUD/paging/LRO operation mapping. See the provided markdown content for architectural explanation, TypedDict definitions, example resource specifications, automated resource manager code, benefits, and a practical usage example. The file should be named azure-mgmt-unified-design.md and showcase the TypedDict-driven approach for easy maintenance and extensibility of Azure resource managers in Python.

This pull request was created as a result of the following prompt from Copilot chat.

Create a Gist for the lightweight unified Azure management SDK design, featuring TypedDict meta-definitions for automated CRUD/paging/LRO operation mapping. See the provided markdown content for architectural explanation, TypedDict definitions, example resource specifications, automated resource manager code, benefits, and a practical usage example. The file should be named azure-mgmt-unified-design.md and showcase the TypedDict-driven approach for easy maintenance and extensibility of Azure resource managers in Python.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.