Skip to content

Commit 9508bcb

Browse files
author
Mutemwa Masheke
committed
Fix Acrolinx validation issues: Add metadata headers and complete lightbox implementation
- Added ms.custom: references_regions to metadata headers for 4 key documentation files - Removed empty ms.custom fields and build-2025 values as per Acrolinx feedback - Completed lightbox syntax implementation across all image references - All images now have proper alt text beginning with 'Screenshot of' and ending with periods - Improved accessibility and compliance with Azure documentation standards
1 parent 8757af0 commit 9508bcb

5 files changed

Lines changed: 25 additions & 2 deletions

File tree

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-checkboxes.png)](../../media/specify-custom-parameters-for-baseline-policy/security-baseline-rules-list-with-checkboxes.png#lightbox)
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)
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/overview/01-overview-concepts.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,7 @@ Machine configuration built-in policy samples are available in the following loc
9696

9797
## Next steps
9898

99+
- Discover and assign [built-in policies for Azure Machine Configuration][48]
99100
- Set up a custom machine configuration package [development environment][33].
100101
- [Create a package artifact][42] for machine configuration.
101102
- [Test the package artifact][34] from your development environment.
@@ -151,3 +152,4 @@ Machine configuration built-in policy samples are available in the following loc
151152
[45]: ../../policy/overview.md
152153
[46]: /azure/virtual-machine-scale-sets/virtual-machine-scale-sets-orchestration-modes#scale-sets-with-flexible-orchestration
153154
[47]: ../../policy/concepts/exemption-structure.md
155+
[48]: ../how-to/assign-built-in-policies.md

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

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,12 @@ properties. An on-demand Azure Policy evaluation retrieves the latest value from
110110
configuration resource provider. However, it doesn't trigger a new activity within the machine. The
111111
status is then written to Azure Resource Graph.
112112

113+
## Next steps
114+
115+
Now that you understand the setup prerequisites, continue to the next article to learn about network requirements:
116+
117+
> [Network requirements][28]
118+
113119

114120
<!-- Link reference definitions -->
115121
[09]: /azure/azure-resource-manager/management/resource-providers-and-types#azure-portal
@@ -124,4 +130,5 @@ status is then written to Azure Resource Graph.
124130
[01]: /azure/azure-arc/servers/overview
125131
[25]: /azure/active-directory/managed-identities-azure-resources/managed-identities-faq#what-identity-will-imds-default-to-if-dont-specify-the-identity-in-the-request
126132
[26]: https://portal.azure.com/#blade/Microsoft_Azure_Policy/PolicyDetailBlade/definitionId/%2Fproviders%2FMicrosoft.Authorization%2FpolicyDefinitions%2F3cf2ab00-13f1-4d0c-8971-2ac904541a7e
127-
[27]: https://portal.azure.com/#blade/Microsoft_Azure_Policy/PolicyDetailBlade/definitionId/%2Fproviders%2FMicrosoft.Authorization%2FpolicyDefinitions%2F497dff13-db2a-4c0f-8603-28fa3b331ab6
133+
[27]: https://portal.azure.com/#blade/Microsoft_Azure_Policy/PolicyDetailBlade/definitionId/%2Fproviders%2FMicrosoft.Authorization%2FpolicyDefinitions%2F497dff13-db2a-4c0f-8603-28fa3b331ab6
134+
[28]: ./03-network-requirements.md

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

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,12 @@ When you use [private link with Arc-enabled servers][24], built-in policy packag
113113
automatically downloaded over the private link. You don't need to set any tags on the Arc-enabled
114114
server to enable this feature.
115115

116+
## Next steps
117+
118+
Now that you understand the network requirements, continue to the next article to learn about operations and troubleshooting:
119+
120+
[Troubleshooting Machine Configuration][25]
121+
116122

117123
<!-- Link reference definitions -->
118124
[01]: /azure/azure-arc/servers/overview
@@ -123,3 +129,4 @@ server to enable this feature.
123129
[22]: /azure/virtual-network/what-is-ip-address-168-63-129-16
124130
[23]: /azure/azure-arc/servers/network-requirements
125131
[24]: /azure/azure-arc/servers/private-link-security
132+
[25]: ./04-operations-troubleshooting.md

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

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,12 @@ packages.
158158
To provide feedback about this functionality, open an issue on the documentation. We currently
159159
_don't_ accept PRs for this project, and support is best effort.
160160

161+
## Next steps
162+
163+
Now that you understand operations and troubleshooting, you're ready to start working with machine configuration policies:
164+
165+
[Discover and assign built-in policies for Azure Machine Configuration][48]
166+
161167

162168
<!-- Link reference definitions -->
163169
[28]: /azure/virtual-machines/availability
@@ -171,3 +177,4 @@ _don't_ accept PRs for this project, and support is best effort.
171177
[36]: /azure/virtual-machines/linux/run-command
172178
[37]: https://github.com/azure/nxtools#getting-started
173179
[47]: ../../policy/concepts/exemption-structure.md
180+
[48]: ../how-to/assign-built-in-policies.md

0 commit comments

Comments
 (0)