acrolinx fixes

alexwolfmsft · alexwolfmsft · commit e83aa4945984 · 2025-08-13T14:02:53.000-04:00
diff --git a/articles/azure-developer-cli/azd-schema.md b/articles/azure-developer-cli/azd-schema.md
@@ -15,7 +15,7 @@ ms.service: azure-dev-cli
 
 ## Sample
 
-Below is a generic example of an `azure.yaml` required for your `azd` template.
+The following is a generic example of an `azure.yaml` required for your `azd` template.
 
 ```yaml
 name: yourApp
@@ -52,13 +52,13 @@ services:
 | Element Name | Required | Description |
 | ------------ | -------- | ----------- |
 | `name` | Y | _(string)_ Name of the application. |
-| `resourceGroup` | N | _(string)_ Name of the Azure resource group. When specified, will override the resource group name used for infrastructure provisioning. |
+| `resourceGroup` | N | _(string)_ Name of the Azure resource group. When specified, overrides the resource group name used for infrastructure provisioning. |
 | `metadata` | N | _(object)_ See [metadata properties](#metadata-properties) for more details. |
 | `infra` | N | _(object)_ Provides extra configuration for Azure infrastructure provisioning. See [infra properties](#infra-properties) for more details. |
 | `services` | Y | _(object)_ Definition of services that comprise the application. See [services properties](#services-properties) for more details. |
 | `pipeline` | N | _(object)_ Definition of continuous integration pipeline. See [pipeline properties](#pipeline-properties) for more details. |
-| `hooks` | N | Command level hooks. Hooks should match `azd` command names prefixed with `pre` or `post` depending on when the script should execute. When specifying paths they should be relative to the project path. See [Customize your Azure Developer CLI workflows using command and event hooks](./azd-extensibility.md) for more details. |
-| `requiredVersions` | N |A range of supported versions of `azd` for this project. If the version of `azd` is outside this range, the project will fail to load. Optional (allows all versions if absent). Example: `>= 0.6.0-beta.3` |
+| `hooks` | N | Command level hooks. Hooks should match `azd` command names prefixed with `pre` or `post` depending on when the script should execute. When specifying paths, they should be relative to the project path. See [Customize your Azure Developer CLI workflows using command and event hooks](./azd-extensibility.md) for more details. |
+| `requiredVersions` | N |A range of supported versions of `azd` for this project. If the version of `azd` is outside this range, the project fails to load. Optional (allows all versions if absent). Example: `>= 0.6.0-beta.3` |
 
 ### `metadata` properties
 
@@ -70,7 +70,7 @@ services:
 
 | Element Name | Required | Description | Example |
 | --- | --- | --- | --- |
-| `provider` | N | _(string)_ The infrastructure provider for the application's Azure resources. (Default: bicep). | See the [Terraform sample](#terraform-as-iac-provider-sample) below. `bicep`, `terraform` |
+| `provider` | N | _(string)_ The infrastructure provider for the application's Azure resources. (Default: bicep). | See the [Terraform sample](#terraform-as-iac-provider-sample). `bicep`, `terraform` |
 | `path` | N | _(string)_ The relative folder path to the location containing Azure provisioning templates for the specified provider. (Default: infra). |  |
 | `module` | N | _(string)_ The name of the default module withing the Azure provisioning templates. (Default: main). |  |
 
@@ -98,15 +98,15 @@ infra:
 
 | Element Name | Required | Description | Example |
 | --- | --- | --- | --- |
-| `resourceName` | N | _(string)_ Name of the Azure resource that implements the service. If not specified, `azd` will look for a resource by `azd-env-name` and `azd-service-name` tags. If not found, it will look for a resource name constructed from the current environment name, concatenated with the service name (`<environment-name><resource-name>`). | `prodapi` |
+| `resourceName` | N | _(string)_ Name of the Azure resource that implements the service. If not specified, `azd` looks for a resource by `azd-env-name` and `azd-service-name` tags. If not found, it looks for a resource name constructed from the current environment name, concatenated with the service name (`<environment-name><resource-name>`). | `prodapi` |
 | `project` | Y | _(string)_ Path to the service source code directory. |  |
-| `host` | Y | _(string)_ Type of Azure resource used for service implementation. If omitted, App Service will be assumed. | `appservice`, `containerapp`, `function`, `staticwebapp`, `aks` (only for projects deployable via `kubectl apply -f`), `springapp` (when [enabled](https://aka.ms/azd-may-2023) - learn more about [alpha features](./feature-versioning.md#alpha-features)) | 
+| `host` | Y | _(string)_ Type of Azure resource used for service implementation. If omitted, App Service is assumed. | `appservice`, `containerapp`, `function`, `staticwebapp`, `aks` (only for projects deployable via `kubectl apply -f`), `springapp` (when [enabled](https://aka.ms/azd-may-2023) - learn more about [alpha features](./feature-versioning.md#alpha-features)) | 
 | `language` | Y | _(string)_ Service implementation language. | `dotnet`, `csharp`, `fsharp`, `py`, `python`, `js`, `ts`, `java` |
-| `module` | Y | _(string)_ Path of the infrastructure module used to deploy the service relative to the root infra folder. If omitted, the CLI will assume the module name is the same as the service name. |  |
-| `dist` | Y | _(string)_ Relative path to the service deployment artifacts. The CLI will use files under this path to create the deployment artifact (.zip file). If omitted, all files under the service project directory will be included. | `build` |
-| `docker` | N | Only applicable when `host` is `containerapp`. Can't contain extra properties. | See the [custom Docker sample](#docker-options-sample) below. `path` _(string)_: Path to the Dockerfile. Default: `./Dockerfile`; `context` _(string)_: The docker build context. When specified, overrides default context. Default: `.`; `platform` _(string)_: The platform target. Default: `amd64`; `remoteBuild` _(boolean)_: Enables remote ACR builds. Default: `false` |
-| `k8s` | N | The Azure Kubernetes Service (AKS) configuration options. | See the [AKS sample](#aks-sample-with-service-level-hooks) below. `deploymentPath` _(string)_: Optional. The relative path from the service path to the k8s deployment manifests. When set, it will override the default deployment path location for k8s deployment manifests. Default: `manifests`; `namespace` _(string)_: Optional. The k8s namespace of the deployed resources. When specified, a new k8s namespace will be created if it does not already exist. Default: `Project name`; `deployment` _(object)_: See [deployment properties](#aks-deployment-properties); `service` _(object)_: See [service properties](#aks-service-properties); `ingress` _(object)_: See [ingress properties](#aks-ingress-properties).  |
-| `hooks` | N | Service level hooks. Hooks should match `service` event names prefixed with `pre` or `post` depending on when the script should execute. When specifying paths they should be relative to the service path. | See [Customize your Azure Developer CLI workflows using command and event hooks](./azd-extensibility.md) for more details. |
+| `module` | Y | _(string)_ Path of the infrastructure module used to deploy the service relative to the root infra folder. If omitted, the CLI assumes the module name is the same as the service name. |  |
+| `dist` | Y | _(string)_ Relative path to the service deployment artifacts. The CLI uses files under this path to create the deployment artifact (.zip file). If omitted, all files under the service project directory are included. | `build` |
+| `docker` | N | Only applicable when `host` is `containerapp`. Can't contain extra properties. | See the [custom Docker sample](#docker-options-sample). `path` _(string)_: Path to the Dockerfile. Default: `./Dockerfile`; `context` _(string)_: The docker build context. When specified, overrides default context. Default: `.`; `platform` _(string)_: The platform target. Default: `amd64`; `remoteBuild` _(boolean)_: Enables remote ACR builds. Default: `false` |
+| `k8s` | N | The Azure Kubernetes Service (AKS) configuration options. | See the [AKS sample](#aks-sample-with-service-level-hooks). `deploymentPath` _(string)_: Optional. The relative path from the service path to the K8s deployment manifests. When set, it overrides the default deployment path location for K8s deployment manifests. Default: `manifests`; `namespace` _(string)_: Optional. The K8s namespace of the deployed resources. When specified, a new K8s namespace is created if it doesn't already exist. Default: `Project name`; `deployment` _(object)_: See [deployment properties](#aks-deployment-properties); `service` _(object)_: See [service properties](#aks-service-properties); `ingress` _(object)_: See [ingress properties](#aks-ingress-properties).  |
+| `hooks` | N | Service level hooks. Hooks should match `service` event names prefixed with `pre` or `post` depending on when the script should execute. When you specify paths, they should be relative to the service path. | See [Customize your Azure Developer CLI workflows using command and event hooks](./azd-extensibility.md) for more details. |
 | `apiVersion` | N | Specify an explicit `api-version` when deploying services hosted by Azure Container Apps (ACA). This feature helps you avoid using an incompatible API version and makes deployment more loosely coupled to avoid losing custom configuration data during JSON marshaling to a hard-coded Azure SDK library version. | `apiVersion: 2024-02-02-preview` |
 
 #### Docker options sample
@@ -137,20 +137,20 @@ services:
 
 | Element Name | Required | Description | Example |
 | --- | --- | --- | --- |
-| `name` | N | _(string)_ Optional. The name of the k8s deployment resource to use during deployment. Used during deployment to ensure if the k8s deployment rollout has been completed. If not set, will search for a deployment resource in the same namespace that contains the service name. Default: `Service name` | `api` |
+| `name` | N | _(string)_ Optional. The name of the K8s deployment resource to use during deployment. Used during deployment to ensure if the K8s deployment rollout completed. If not set, searches for a deployment resource in the same namespace that contains the service name. Default: `Service name` | `api` |
 
 ### AKS `service` properties
 
 | Element Name | Required | Description | Example |
 | --- | --- | --- | --- |
-| `name` | N | _(string)_ Optional. The name of the k8s service resource to use as the default service endpoint. Used when determining endpoints for the default service resource. If not set, will search for a deployment resource in the same namespace that contains the service name. (Default: Service name)  | `api` |
+| `name` | N | _(string)_ Optional. The name of the K8s service resource to use as the default service endpoint. Used when determining endpoints for the default service resource. If not set, searches for a deployment resource in the same namespace that contains the service name. (Default: Service name)  | `api` |
 
 ### AKS `ingress` properties
 
 | Element Name | Required | Description | Example |
 | --- | --- | --- | --- |
-| `name` | N | _(string)_ Optional. The name of the k8s ingress resource to use as the default service endpoint. Used when determining endpoints for the default ingress resource. If not set, will search for a deployment resource in the same namespace that contains the service name. Default: `Service name` | `api` |
-| `relativePath` | N | _(string)_ Optional. The relative path to the service from the root of your ingress controller. When set, will be appended to the root of your ingress resource path. | |
+| `name` | N | _(string)_ Optional. The name of the K8s ingress resource to use as the default service endpoint. Used when determining endpoints for the default ingress resource. If not set, searches for a deployment resource in the same namespace that contains the service name. Default: `Service name` | `api` |
+| `relativePath` | N | _(string)_ Optional. The relative path to the service from the root of your ingress controller. When set, appends to the root of your ingress resource path. | |
 
 ### AKS sample with service level hooks
 
@@ -204,7 +204,7 @@ pipeline:
 
 | Element Name | Type   | Required | Description |
 |--------------|--------|----------|-------------|
-| up           | object | No       | When specified will override the default behavior for the azd up workflow. |
+| up           | object | No       | When specified overrides the default behavior for the azd up workflow. |
 
 #### `up` properties
 
