docs(azure): add explanatory sentences before every az command block

Every code block in the 25 new service articles now has a prose sentence
immediately before it describing what the command does. Previously, many
blocks were preceded only by a section heading.

Author: paolosalvatori

src/content/docs/azure/services/action-group.mdx

@@ -36,6 +36,8 @@ This reconfigures the `az` CLI to send commands to the official Azure management
 
 ### Create a resource group
 
+Create a resource group to hold all resources created in this guide:
+
 ```bash
 az group create --name rg-monit-demo --location eastus
 ```
@@ -52,6 +54,8 @@ az group create --name rg-monit-demo --location eastus
 
 ### Create an action group
 
+Create an action group with an email receiver as the notification endpoint:
+
 ```bash
 az monitor action-group create \
   --name my-action-group \
@@ -80,6 +84,8 @@ az monitor action-group create \
 
 ### Show and list action groups
 
+Retrieve the details of the action group, then list all action groups in the resource group:
+
 ```bash
 az monitor action-group show \
   --name my-action-group \
@@ -130,6 +136,8 @@ az monitor action-group list \
 
 ### Update an action group
 
+Update the action group to add a second email receiver:
+
 ```bash
 az monitor action-group update \
   --name my-action-group \
@@ -154,6 +162,8 @@ az monitor action-group update \
 
 ### Delete and verify
 
+Delete the resource and confirm it no longer appears in the list:
+
 ```bash
 az monitor action-group delete \
   --name my-action-group \

src/content/docs/azure/services/api-management.mdx

@@ -36,6 +36,8 @@ This reconfigures the `az` CLI to send commands to the official Azure management
 
 ### Create a resource group
 
+Create a resource group to hold all resources created in this guide:
+
 ```bash
 az group create --name rg-apim-demo --location eastus
 ```
@@ -52,6 +54,8 @@ az group create --name rg-apim-demo --location eastus
 
 ### Create an API Management service instance
 
+Create an API Management instance in the Consumption tier:
+
 ```bash
 az apim create \
   --name my-apim \
@@ -80,6 +84,8 @@ az apim create \
 
 ### Show and list services
 
+Retrieve the details of the service instance and list all instances in the resource group:
+
 ```bash
 az apim show --name my-apim --resource-group rg-apim-demo
 ```
@@ -118,6 +124,8 @@ az apim list --resource-group rg-apim-demo
 
 ### Check service name availability
 
+Check whether the service name is globally available before creating:
+
 ```bash
 az apim check-name --name my-apim
 ```
@@ -149,6 +157,8 @@ az rest --method PUT \
 
 ### Create an API gateway
 
+Create an API gateway resource within the service instance using the REST API:
+
 ```bash
 az rest --method PUT \
   --url "https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/rg-apim-demo/providers/Microsoft.ApiManagement/gateways/my-gateway?api-version=2022-08-01" \
@@ -162,6 +172,8 @@ az rest --method PUT \
 
 ### Delete and verify
 
+Delete the resource and confirm it no longer appears in the list:
+
 ```bash
 az apim delete --name my-apim --resource-group rg-apim-demo --yes
 az apim list --resource-group rg-apim-demo

src/content/docs/azure/services/application-insights.mdx

@@ -36,6 +36,8 @@ This reconfigures the `az` CLI to send commands to the official Azure management
 
 ### Create a resource group
 
+Create a resource group to hold all resources created in this guide:
+
 ```bash
 az group create --name rg-insights-demo --location eastus
 ```
@@ -52,6 +54,8 @@ az group create --name rg-insights-demo --location eastus
 
 ### Create an Application Insights component
 
+Create an Application Insights component linked to a Log Analytics workspace:
+
 ```bash
 az monitor app-insights component create \
   --app my-app-insights \
@@ -79,6 +83,8 @@ az monitor app-insights component create \
 
 ### Show and list components
 
+Retrieve the details of the component and list all components in the resource group:
+
 ```bash
 az monitor app-insights component show \
   --app my-app-insights \
@@ -106,6 +112,8 @@ az monitor app-insights component list \
 
 ### Retrieve billing features
 
+Retrieve the current billing features and daily data volume cap for the component:
+
 ```bash
 az monitor app-insights component billing show \
   --app my-app-insights \
@@ -126,6 +134,8 @@ az monitor app-insights component billing show \
 
 ### Update billing features
 
+Update the daily data volume cap to limit ingestion costs:
+
 ```bash
 az monitor app-insights component billing update \
   --app my-app-insights \
@@ -147,6 +157,8 @@ az monitor app-insights component billing update \
 
 ### Delete and verify
 
+Delete the resource and confirm it no longer appears in the list:
+
 ```bash
 az monitor app-insights component delete \
   --app my-app-insights \

src/content/docs/azure/services/autoscale-setting.mdx

@@ -36,6 +36,8 @@ This reconfigures the `az` CLI to send commands to the official Azure management
 
 ### Create a resource group
 
+Create a resource group to hold all resources created in this guide:
+
 ```bash
 az group create --name rg-autoscale-demo --location eastus
 ```
@@ -52,6 +54,8 @@ az group create --name rg-autoscale-demo --location eastus
 
 ### Create an App Service plan
 
+Create an App Service plan to use as the autoscale target:
+
 ```bash
 az appservice plan create \
   --name my-plan \
@@ -75,6 +79,8 @@ az appservice plan create \
 
 ### Create an autoscale setting
 
+Create an autoscale setting linked to the App Service plan:
+
 ```bash
 az monitor autoscale create \
   --name my-autoscale \
@@ -107,6 +113,8 @@ az monitor autoscale create \
 
 ### Add a scale-out rule
 
+Add a scale-out rule that increases the instance count when average CPU usage rises above 70%:
+
 ```bash
 az monitor autoscale rule create \
   --autoscale-name my-autoscale \
@@ -137,6 +145,8 @@ az monitor autoscale rule create \
 
 ### Show and list autoscale settings
 
+Retrieve the details of the autoscale setting and list all settings in the resource group:
+
 ```bash
 az monitor autoscale show \
   --name my-autoscale \
@@ -184,6 +194,8 @@ az monitor autoscale list \
 
 ### Delete and verify
 
+Delete the resource and confirm it no longer appears in the list:
+
 ```bash
 az monitor autoscale delete \
   --name my-autoscale \

src/content/docs/azure/services/bastion-host.mdx

@@ -107,6 +107,8 @@ az network vnet subnet create \
 
 ### Create a Standard public IP address
 
+Create a Standard SKU static public IP address required by the Bastion host:
+
 ```bash
 az network public-ip create \
   --name pip-bastion \
@@ -136,6 +138,8 @@ az network public-ip create \
 
 ### Create a bastion host
 
+Create the Bastion host, linking it to the virtual network and the public IP address:
+
 ```bash
 az network bastion create \
   --name bastion-demo \
@@ -174,6 +178,8 @@ az network bastion create \
 
 ### Get and list bastion hosts
 
+Retrieve the details of the Bastion host and list all Bastion instances in the resource group:
+
 ```bash
 az network bastion show \
   --name bastion-demo \
@@ -237,6 +243,8 @@ az network bastion list \
 
 ### Delete the bastion host
 
+Delete the Bastion host and verify it no longer appears in the list:
+
 ```bash
 az network bastion delete \
   --name bastion-demo \

src/content/docs/azure/services/container-registry.mdx

@@ -36,6 +36,8 @@ This reconfigures the `az` CLI to send commands to the official Azure management
 
 ### Create a resource group
 
+Create a resource group to hold all resources created in this guide:
+
 ```bash
 az group create --name rg-acr-demo --location eastus
 ```
@@ -52,6 +54,8 @@ az group create --name rg-acr-demo --location eastus
 
 ### Create a container registry
 
+Create a Standard-tier Azure Container Registry:
+
 ```bash
 az acr create \
   --name myacrdemo \
@@ -77,12 +81,16 @@ az acr create \
 
 ### Log in with Docker
 
+Authenticate the local Docker daemon to the registry using the Azure CLI:
+
 ```bash
 az acr login --name myacrdemo
 ```
 
 ### Build and push an image
 
+Build a local Docker image and push it to the registry endpoint:
+
 ```bash
 docker build -t myacrdemo.azurecr.io/hello:v1 .
 docker push myacrdemo.azurecr.io/hello:v1
@@ -99,12 +107,16 @@ az acr build \
 
 ### Pull an image
 
+Pull the image back from the registry to confirm it was pushed correctly:
+
 ```bash
 docker pull myacrdemo.azurecr.io/hello:v1
 ```
 
 ### List repositories
 
+List all image repositories stored in the registry:
+
 ```bash
 az acr repository list --name myacrdemo
 ```
@@ -115,6 +127,8 @@ az acr repository list --name myacrdemo
 
 ### Check name availability
 
+Check that the registry name is globally available before creating:
+
 ```bash
 az acr check-name --name myacrdemo
 ```
@@ -129,6 +143,8 @@ az acr check-name --name myacrdemo
 
 ### Update registry settings
 
+Enable the admin user account on the registry:
+
 ```bash
 az acr update --name myacrdemo --resource-group rg-acr-demo --admin-enabled false
 ```
@@ -149,6 +165,8 @@ az acr update --name myacrdemo --resource-group rg-acr-demo --admin-enabled fals
 
 ### Show registry usage
 
+Show current storage usage statistics for the registry:
+
 ```bash
 az acr show-usage --name myacrdemo --resource-group rg-acr-demo
 ```
@@ -166,6 +184,8 @@ az acr show-usage --name myacrdemo --resource-group rg-acr-demo
 
 ### Delete and verify
 
+Delete the resource and confirm it no longer appears in the list:
+
 ```bash
 az acr delete --name myacrdemo --resource-group rg-acr-demo --yes
 az acr list --resource-group rg-acr-demo