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-avd for 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
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/:avd-on-azure-local.mdaks-on-azure-local.mdapp-services-on-azure-local.mdsql-managed-instance-on-azure-local.mdml-ai-on-azure-local.mdiot-operations-on-azure-local.mdvms-and-containers-on-azure-local.mddisconnected-operations-on-azure-local.mdEach 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)
2. Repository Information
AzureLocal/azurelocal-avdfor AVD)3. Documentation Site Link
https://azurelocal.github.io/azurelocal-avd/)4. External References
Services with Existing Repos
The following services have repos in the
AzureLocalorg and should link to them:AzureLocal/azurelocal-avdhttps://azurelocal.github.io/azurelocal-avd/AzureLocal/azurelocal-sofs-fslogixhttps://azurelocal.github.io/azurelocal-sofs-fslogix/AzureLocal/azurelocal-loadtoolshttps://azurelocal.github.io/azurelocal-loadtools/AzureLocal/azurelocal-vm-conversion-toolkithttps://azurelocal.github.io/azurelocal-vm-conversion-toolkit/AzureLocal/azurelocal-toolkithttps://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.mdshould 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
product-azure-local-anywhere/azure-services-on-azure-local/(that directory is being removed per separate issue)