Skip to content

Commit faf4a2b

Browse files
author
Mutemwa Masheke
committed
Fix remaining Acrolinx validation feedback
- Added ms.custom: references_regions to 4 remaining files (understand-baseline-settings-parameter.md, 02-setup-prerequisites.md, 03-network-requirements.md, 04-operations-troubleshooting.md) - Added introductory paragraph to 02-setup-prerequisites.md between H1 and first H2 - Fixed sequential steps formatting: Changed numbered sub-lists to bullets for non-sequential items in deploy-a-baseline-policy-assignment.md and assign-built-in-policies.md - Improved document structure and compliance with Azure documentation standards
1 parent 9508bcb commit faf4a2b

7 files changed

Lines changed: 18 additions & 12 deletions

File tree

articles/governance/machine-configuration/how-to/assign-built-in-policies.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -29,19 +29,19 @@ To view and explore these built-in policies:
2929

3030
4. Browse the list to review available definitions, such as:
3131

32-
1. *Audit Linux machines that have the specified applications installed*
32+
- *Audit Linux machines that have the specified applications installed*
3333

34-
2. *Audit Windows machines that are not set to the specified time zone*
34+
- *Audit Windows machines that are not set to the specified time zone*
3535

36-
3. *Windows machines should meet requirements for the Azure compute security baseline*
36+
- *Windows machines should meet requirements for the Azure compute security baseline*
3737

3838
5. Click any policy name to open its details page. You can inspect:
3939

40-
1. The JSON definition
40+
- The JSON definition
4141

42-
2. Available parameters and versions
42+
- Available parameters and versions
4343

44-
3. Metadata such as category, mode, and required providers
44+
- Metadata such as category, mode, and required providers
4545

4646
[![Screenshot of policy definition details page showing JSON definition and parameters.](../media/discover-and-assign-built-in-machine-configuration-policies/policy-definition-details-json-parameters.png)](../media/discover-and-assign-built-in-machine-configuration-policies/policy-definition-details-json-parameters.png#lightbox)
4747

articles/governance/machine-configuration/how-to/assign-security-baselines/deploy-a-baseline-policy-assignment.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,11 @@ The portal provides the most direct path to create or test a baseline assignment
3333

3434
2. Under **Definitions**, choose your desired baseline—for example:
3535

36-
1. *\[Preview\]* Official CIS Security Benchmarks for Linux Workloads
36+
- *\[Preview\]* Official CIS Security Benchmarks for Linux Workloads
3737

38-
2. *Azure Security Baseline for Windows*
38+
- *Azure Security Baseline for Windows*
3939

40-
3. *Azure Security Baseline for Linux*
40+
- *Azure Security Baseline for Linux*
4141

4242
### Step 2—Select and Customize
4343

@@ -58,9 +58,9 @@ Use this file later when creating the assignment.
5858

5959
2. In the page, define:
6060

61-
1. **Scope** (subscription or management group)
61+
- **Scope** (subscription or management group)
6262

63-
2. **Assignment name** and optional description
63+
- **Assignment name** and optional description
6464

6565
3. Under the **Parameters** tab, locate **Baseline Settings**. You may need to uncheck *"Only show parameters that need input or review"*
6666

articles/governance/machine-configuration/how-to/assign-security-baselines/specify-custom-parameters-for-baseline-policy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ On the **Modify settings** tab, review and adjust configuration rules for your s
5454

5555
- For configurable rules, edit the **Parameter value** field to define your organization's required state.
5656

57-
[![Screenshot of security baseline rules list with checkboxes and parameter value fields.](../../media/specify-custom-parameters-for-baseline-policy/security-baseline-rules-list-with-checked-boxes.png)](../../media/specify-custom-parameters-for-baseline-policy/security-baseline-rules-list-with-checked-boxes.png#lightbox)
57+
[![Screenshot of security baseline rules list with checkboxes and parameter value fields.](../../media/specify-custom-parameters-for-baseline-policy/security-base-line-rules-list-with-checked-boxes.png)](../../media/specify-custom-parameters-for-baseline-policy/security-base-line-rules-list-with-checked-boxes.png#lightbox)
5858

5959
- View per rule Metadata by clicking on a highlighted rule. This action opens the context pane showing details such as **Rule ID**, **Description**, **Severity**, and **Compliance Standard**.
6060

articles/governance/machine-configuration/how-to/assign-security-baselines/understand-baseline-settings-parameter.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Understand The Baseline Settings Parameter Format
33
description: Learn how to read and author baseline JSON parameters for Azure Machine Configuration security baselines including CIS Linux Benchmarks and Azure Security Baselines for Windows and Linux.
44
ms.date: 11/07/2025
55
ms.topic: conceptual
6+
ms.custom: references_regions
67
---
78

89
# Understand the Baseline Settings Parameter Format

articles/governance/machine-configuration/overview/02-setup-prerequisites.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,13 @@ description: Configure the required components, extensions, and identities neede
33
ms.date: 11/07/2025
44
ms.topic: how-to
55
title: Azure Machine Configuration prerequisites
6+
ms.custom: references_regions
67
---
78

89
# Azure Machine Configuration prerequisites
910

11+
Azure Machine Configuration provides native capability to audit or configure operating system settings as code, both for machines running in Azure and hybrid Arc-enabled machines. Before you can use machine configuration to manage your environment, you must enable the prerequisites for the service.
12+
1013
## Enable machine configuration
1114

1215
To manage the state of machines in your environment, including machines in Azure

articles/governance/machine-configuration/overview/03-network-requirements.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ description: Configure network connectivity, endpoints, and private link setting
33
ms.date: 11/07/2025
44
ms.topic: how-to
55
title: Azure Machine Configuration network requirements
6+
ms.custom: references_regions
67
---
78

89
# Azure Machine Configuration network requirements

articles/governance/machine-configuration/overview/04-operations-troubleshooting.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ description: Monitor, troubleshoot, and manage Azure Machine Configuration deplo
33
ms.date: 11/07/2025
44
ms.topic: how-to
55
title: Troubleshooting Azure Machine Configuration
6+
ms.custom: references_regions
67
---
78

89
# Troubleshooting Azure Machine Configuration

0 commit comments

Comments
 (0)