Skip to content

Enrich "Azure Services on Azure Local" pages with service details, repo info, and links #18

@kristopherjturner

Description

@kristopherjturner

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

  • 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)

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions