Enrich "Azure Services on Azure Local" pages with service details, repo info, and links #18
Description
Summary
Each page in the Azure Services on Azure Local section (docs/azure-services/) is currently a thin stub with only a brief overview, supported features, deployment notes, and limitations. These pages need to be enriched so they serve as proper landing pages for each service — with service details, links to the related repo, and links to the repo's documentation site.
Current State
There are 8 service pages + 1 index in docs/azure-services/:
| File | Service |
|---|---|
avd-on-azure-local.md |
Azure Virtual Desktop |
aks-on-azure-local.md |
Azure Kubernetes Service |
app-services-on-azure-local.md |
Azure App Services |
sql-managed-instance-on-azure-local.md |
Azure SQL Managed Instance |
ml-ai-on-azure-local.md |
Machine Learning / AI at the Edge |
iot-operations-on-azure-local.md |
IoT Operations |
vms-and-containers-on-azure-local.md |
VMs and Containers |
disconnected-operations-on-azure-local.md |
Disconnected Operations |
Each page currently has ~25 lines with generic bullet points and no links to repos or external documentation sites.
Requirements
Each service page should be updated with the following sections:
1. Service Details (expanded)
- Richer description of the service and what it enables on Azure Local
- Key use cases and scenarios
- Architecture notes (how it integrates with Azure Local infrastructure)
2. Repository Information
- Link to the GitHub repo (where applicable, e.g.,
AzureLocal/azurelocal-avdfor AVD) - Brief description of what the repo contains (scripts, templates, configuration)
- Getting started reference pointing to the repo's README
3. Documentation Site Link
- Link to the repo's GitHub Pages documentation site (e.g.,
https://azurelocal.github.io/azurelocal-avd/) - Brief note about what the docs site covers
4. External References
- Link to official Microsoft Learn documentation for the service on Azure Local
- Any other relevant external resources
Services with Existing Repos
The following services have repos in the AzureLocal org and should link to them:
| Service | Repo | Docs Site |
|---|---|---|
| AVD | AzureLocal/azurelocal-avd |
https://azurelocal.github.io/azurelocal-avd/ |
| SOFS for FSLogix | AzureLocal/azurelocal-sofs-fslogix |
https://azurelocal.github.io/azurelocal-sofs-fslogix/ |
| Load Testing | AzureLocal/azurelocal-loadtools |
https://azurelocal.github.io/azurelocal-loadtools/ |
| VM Conversion | AzureLocal/azurelocal-vm-conversion-toolkit |
https://azurelocal.github.io/azurelocal-vm-conversion-toolkit/ |
| Toolkit | AzureLocal/azurelocal-toolkit |
https://azurelocal.github.io/azurelocal-toolkit/ |
Services without a dedicated repo should still have enriched service details and links to Microsoft Learn.
Index Page
The docs/azure-services/index.md should also be updated to provide a richer overview with links to each service sub-page and a table summarizing which services have repos, docs sites, etc.
Acceptance Criteria
- All 8 service pages have expanded service details (description, use cases, architecture notes)
- Pages for services with repos include: repo link, repo description, getting started reference
- Pages for services with repos include: docs site link with description
- All pages include link to official Microsoft Learn documentation
- Index page updated with summary table and links
- All links are verified working
- No duplicate content with
product-azure-local-anywhere/azure-services-on-azure-local/(that directory is being removed per separate issue)