Skip to content

Commit 76f3589

Browse files
michaeltlombardimichaeltlombardi
committed
(AB#85432) Rename machine configuration articles
Prior to this change, nearly all of the machine configuration articles were named with the `machine-configuration-` prefix. They are all located in the `machine-configuration` folder, which made their slug url repeat the phrase `machine-configuration` twice in a row. This change renames the machine configuration articles to make them easier to understand when just reading the names in the repository and to fix the repeated phrase problem in the article slugs. It updates all references inside the folder and adds redirects.
1 parent 79f27cc commit 76f3589

17 files changed

+164
-98
lines changed

‎.openpublishing.redirection.machine-configuration.json

Lines changed: 77 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,63 +7,128 @@
77
},
88
{
99
"source_path_from_root": "/articles/governance/policy/concepts/guest-configuration-policy-effects.md",
10-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-policy-effects",
10+
"redirect_url": "/azure/governance/machine-configuration/remediation-options",
1111
"redirect_document_id": false
1212
},
1313
{
1414
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-desired-state-configuration-extension-migration.md",
15-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-dsc-extension-migration",
15+
"redirect_url": "/azure/governance/machine-configuration/migrate-from-dsc-extension",
1616
"redirect_document_id": false
1717
},
1818
{
1919
"source_path_from_root": "/articles/governance/policy/concepts/guest-configuration-custom.md",
20-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-custom",
20+
"redirect_url": "/azure/governance/machine-configuration/dsc-in-machine-configuration",
2121
"redirect_document_id": false
2222
},
2323
{
2424
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-create.md",
25-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-create",
25+
"redirect_url": "/azure/governance/machine-configuration/how-to-create-package",
2626
"redirect_document_id": false
2727
},
2828
{
2929
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-create-test.md",
30-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-create-test",
30+
"redirect_url": "/azure/governance/machine-configuration/how-to-test-package",
3131
"redirect_document_id": false
3232
},
3333
{
3434
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-create-signing.md",
35-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-create-signing",
35+
"redirect_url": "/azure/governance/machine-configuration/how-to-sign-package",
3636
"redirect_document_id": false
3737
},
3838
{
3939
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-create-setup.md",
40-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-create-setup",
40+
"redirect_url": "/azure/governance/machine-configuration/how-to-set-up-authoring-environment",
4141
"redirect_document_id": false
4242
},
4343
{
4444
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-create-publish.md",
45-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-create-publish",
45+
"redirect_url": "/azure/governance/machine-configuration/how-to-publish-package",
4646
"redirect_document_id": false
4747
},
4848
{
4949
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-create-definition.md",
50-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-create-definition",
50+
"redirect_url": "/azure/governance/machine-configuration/how-to-create-policy-definition",
5151
"redirect_document_id": false
5252
},
5353
{
5454
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-create-assignment.md",
55-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-create-assignment",
55+
"redirect_url": "/azure/governance/machine-configuration/how-to-create-assignment",
5656
"redirect_document_id": false
5757
},
5858
{
5959
"source_path_from_root": "/articles/governance/policy/how-to/guest-configuration-azure-automation-migration.md",
60-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-azure-automation-migration",
60+
"redirect_url": "/azure/governance/machine-configuration/migrate-from-azure-automation",
6161
"redirect_document_id": false
6262
},
6363
{
6464
"source_path_from_root": "/articles/governance/policy/concepts/guest-configuration-assignments.md",
65-
"redirect_url": "/azure/governance/machine-configuration/machine-configuration-assignments",
65+
"redirect_url": "/azure/governance/machine-configuration/assignments",
6666
"redirect_document_id": false
6767
},
68+
{
69+
"source_path_from_root": "/articles/governance/machine-configuration/agent-notes.md",
70+
"redirect_url": "/azure/governance/machine-configuration/agent-release-notes",
71+
"redirect_document_id": false
72+
},
73+
{
74+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-assignments.md",
75+
"redirect_url": "/azure/governance/machine-configuration/assignments",
76+
"redirect_document_id": false
77+
},
78+
{
79+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-azure-automation-migration.md",
80+
"redirect_url": "/azure/governance/machine-configuration/migrate-from-azure-automation",
81+
"redirect_document_id": false
82+
},
83+
{
84+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-create-assignment.md",
85+
"redirect_url": "/azure/governance/machine-configuration/how-to-create-assignment",
86+
"redirect_document_id": false
87+
},
88+
{
89+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-create-definition.md",
90+
"redirect_url": "/azure/governance/machine-configuration/how-to-create-policy-definition",
91+
"redirect_document_id": false
92+
},
93+
{
94+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-create-publish.md",
95+
"redirect_url": "/azure/governance/machine-configuration/how-to-publish-package",
96+
"redirect_document_id": false
97+
},
98+
{
99+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-create-setup.md",
100+
"redirect_url": "/azure/governance/machine-configuration/how-to-set-up-authoring-environment",
101+
"redirect_document_id": false
102+
},
103+
{
104+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-create-signing.md",
105+
"redirect_url": "/azure/governance/machine-configuration/how-to-sign-package",
106+
"redirect_document_id": false
107+
},
108+
{
109+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-create-test.md",
110+
"redirect_url": "/azure/governance/machine-configuration/how-to-test-package",
111+
"redirect_document_id": false
112+
},
113+
{
114+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-create.md",
115+
"redirect_url": "/azure/governance/machine-configuration/how-to-create-package",
116+
"redirect_document_id": false
117+
},
118+
{
119+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-custom.md",
120+
"redirect_url": "/azure/governance/machine-configuration/dsc-in-machine-configuration",
121+
"redirect_document_id": false
122+
},
123+
{
124+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-dsc-extension-migration.md",
125+
"redirect_url": "/azure/governance/machine-configuration/migrate-from-dsc-extension",
126+
"redirect_document_id": false
127+
},
128+
{
129+
"source_path_from_root": "/articles/governance/machine-configuration/machine-configuration-policy-effects.md",
130+
"redirect_url": "/azure/governance/machine-configuration/remediation-options",
131+
"redirect_document_id": false
132+
}
68133
]
69134
}

‎articles/governance/machine-configuration/agent-notes.md renamed to ‎articles/governance/machine-configuration/agent-release-notes.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -88,9 +88,9 @@ az vm extension set \
8888
<!-- Reference link definitions -->
8989
[01]: ../../azure-arc/servers/agent-release-notes.md
9090
[03]: https://msrc.microsoft.com/update-guide/vulnerability/CVE-2022-38007
91-
[04]: ./machine-configuration-create-setup.md
92-
[05]: ./machine-configuration-create.md
93-
[06]: ./machine-configuration-create-test.md
94-
[07]: ./machine-configuration-create-definition.md
91+
[04]: ./how-to-set-up-authoring-environment.md
92+
[05]: ./how-to-create-package.md
93+
[06]: ./how-to-test-package.md
94+
[07]: ./how-to-create-policy-definition.md
9595
[08]: ../policy/assign-policy-portal.md
9696
[09]: ../policy/how-to/determine-non-compliance.md

‎articles/governance/machine-configuration/machine-configuration-assignments.md renamed to ‎articles/governance/machine-configuration/assignments.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -129,9 +129,9 @@ $guestAssignment | Remove-AzResource
129129
[01]: https://youtu.be/DmCphySEB7A
130130
[02]: ../policy/how-to/get-compliance-data.md
131131
[03]: ./overview.md
132-
[04]: ./machine-configuration-create-setup.md
133-
[05]: ./machine-configuration-create.md
134-
[06]: ./machine-configuration-create-test.md
135-
[07]: ./machine-configuration-create-definition.md
132+
[04]: ./how-to-set-up-authoring-environment.md
133+
[05]: ./how-to-create-package.md
134+
[06]: ./how-to-test-package.md
135+
[07]: ./how-to-create-policy-definition.md
136136
[08]: ../policy/assign-policy-portal.md
137137
[09]: ../policy/how-to/determine-non-compliance.md

‎articles/governance/machine-configuration/machine-configuration-custom.md renamed to ‎articles/governance/machine-configuration/dsc-in-machine-configuration.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -336,19 +336,19 @@ DSC versions, so don't try to manage the same settings.
336336
[04]: https://github.com/Microsoft/PowerShell-DSC-for-Linux
337337
[05]: https://www.powershellgallery.com/packages/PSDesiredStateConfiguration
338338
[06]: /powershell/dsc/pull-server/partialConfigs
339-
[07]: ./machine-configuration-create.md
339+
[07]: ./how-to-create-package.md
340340
[08]: ../../automation/automation-dsc-compile.md#compile-your-dsc-configuration-in-windows-powershell
341341
[09]: /powershell/dsc/managing-nodes/metaConfig#basic-settings
342-
[10]: machine-configuration-assignments.md
343-
[11]: ./machine-configuration-policy-effects.md#remediation-on-demand-applyandmonitor
342+
[10]: assignments.md
343+
[11]: ./remediation-options.md#remediation-on-demand-applyandmonitor
344344
[12]: https://github.com/Azure/azure-policy/blob/master/samples/GuestConfiguration/package-samples/resource-modules/SecureProtocolWebServer/DSCResources/SecureWebServer/SecureWebServer.psm1#L253
345345
[13]: /powershell/dsc/configurations/crossnodedependencies
346346
[14]: /powershell/dsc/configurations/reboot-a-node
347347
[15]: https://github.com/microsoft/PowerShell-DSC-for-Linux/tree/master/Providers
348348
[16]: /powershell/dsc/getting-started/wingettingstarted
349349
[17]: /powershell/dsc/getting-started/lnxgettingstarted
350-
[18]: ./machine-configuration-create-setup.md
351-
[19]: ./machine-configuration-create-test.md
352-
[20]: ./machine-configuration-create-definition.md
350+
[18]: ./how-to-set-up-authoring-environment.md
351+
[19]: ./how-to-test-package.md
352+
[20]: ./how-to-create-policy-definition.md
353353
[21]: ../policy/assign-policy-portal.md
354354
[22]: ../policy/how-to/determine-non-compliance.md

‎articles/governance/machine-configuration/machine-configuration-create-assignment.md renamed to ‎articles/governance/machine-configuration/how-to-create-assignment.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -239,9 +239,9 @@ resource "azurerm_virtual_machine_configuration_policy_assignment" "AzureWindows
239239
- [Assign your custom policy definition][16] using Azure portal.
240240

241241
<!-- Reference link definitions -->
242-
[01]: ./machine-configuration-assignments.md
243-
[02]: ./machine-configuration-create-definition.md
244-
[03]: ./machine-configuration-create-publish.md
242+
[01]: ./assignments.md
243+
[02]: ./how-to-create-policy-definition.md
244+
[03]: ./how-to-publish-package.md
245245
[04]: ../policy/samples/built-in-packages.md
246246
[05]: ../../azure-resource-manager/management/extension-resource-types.md
247247
[06]: ../../azure-arc/servers/overview.md
@@ -251,7 +251,7 @@ resource "azurerm_virtual_machine_configuration_policy_assignment" "AzureWindows
251251
[10]: /azure/developer/terraform/get-started-windows-powershell
252252
[11]: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/virtual_machine_configuration_policy_assignment
253253
[12]: ./overview.md
254-
[13]: ./machine-configuration-create-setup.md
255-
[14]: ./machine-configuration-create.md
256-
[15]: ./machine-configuration-create-test.md
254+
[13]: ./how-to-set-up-authoring-environment.md
255+
[14]: ./how-to-create-package.md
256+
[15]: ./how-to-test-package.md
257257
[16]: ../policy/assign-policy-portal.md

‎articles/governance/machine-configuration/machine-configuration-create.md renamed to ‎articles/governance/machine-configuration/how-to-create-package.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -156,11 +156,11 @@ third-party platform in the content artifact.
156156
<!-- Reference link definitions -->
157157
[01]: ./overview.md
158158
[02]: /powershell/dsc/overview
159-
[03]: ./machine-configuration-create-setup.md
159+
[03]: ./how-to-set-up-authoring-environment.md
160160
[04]: /powershell/dsc/getting-started/wingettingstarted#define-a-configuration-and-generate-the-configuration-document
161161
[05]: /powershell/dsc/resources/authoringResourceClass
162162
[06]: https://www.powershellgallery.com/packages?q=Tags%3A%22GuestConfiguration%22
163-
[07]: ./machine-configuration-create-test.md
164-
[08]: ./machine-configuration-create-publish.md
165-
[09]: ./machine-configuration-create-definition.md
163+
[07]: ./how-to-test-package.md
164+
[08]: ./how-to-publish-package.md
165+
[09]: ./how-to-create-policy-definition.md
166166
[10]: ../policy/assign-policy-portal.md

‎articles/governance/machine-configuration/machine-configuration-create-definition.md renamed to ‎articles/governance/machine-configuration/how-to-create-policy-definition.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -285,10 +285,10 @@ updated.
285285

286286
<!-- Reference link definitions -->
287287
[01]: ./overview.md
288-
[02]: ./machine-configuration-policy-effects.md
289-
[03]: ./machine-configuration-create-setup.md
290-
[04]: ./machine-configuration-create.md
291-
[05]: ./machine-configuration-create-test.md
288+
[02]: ./remediation-options.md
289+
[03]: ./how-to-set-up-authoring-environment.md
290+
[04]: ./how-to-create-package.md
291+
[05]: ./how-to-test-package.md
292292
[06]: ../policy/overview.md
293293
[07]: ../policy/assign-policy-portal.md
294294
[08]: ../policy/assign-policy-azurecli.md

‎articles/governance/machine-configuration/machine-configuration-create-publish.md renamed to ‎articles/governance/machine-configuration/how-to-publish-package.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,6 @@ $contenturi = New-AzStorageBlobSASToken @tokenParams
102102
[01]: ./overview.md
103103
[02]: ../../storage/common/storage-sas-overview.md
104104
[03]: ../../storage/common/storage-network-security.md#grant-access-from-a-virtual-network
105-
[04]: ./machine-configuration-create-test.md
106-
[05]: ./machine-configuration-create-definition.md
105+
[04]: ./how-to-test-package.md
106+
[05]: ./how-to-create-policy-definition.md
107107
[06]: ../policy/assign-policy-portal.md

‎articles/governance/machine-configuration/machine-configuration-create-setup.md renamed to ‎articles/governance/machine-configuration/how-to-set-up-authoring-environment.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ Get-Command -Module 'GuestConfiguration'
7272
[01]: https://github.com/PowerShell/PowerShell/releases/tag/v7.1.3
7373
[02]: https://github.com/PowerShell/PowerShell/releases/tag/v7.2.4
7474
[03]: /powershell/azure/install-az-ps
75-
[04]: ./machine-configuration-create.md
76-
[05]: ./machine-configuration-create-test.md
77-
[06]: ./machine-configuration-create-definition.md
75+
[04]: ./how-to-create-package.md
76+
[05]: ./how-to-test-package.md
77+
[06]: ./how-to-create-policy-definition.md
7878
[07]: ../policy/assign-policy-portal.md

‎articles/governance/machine-configuration/machine-configuration-create-signing.md renamed to ‎articles/governance/machine-configuration/how-to-sign-package.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -132,8 +132,8 @@ requirement through the machine configuration extension.
132132
[01]: https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.compute/vm-push-certificate-windows
133133
[02]: ../../virtual-machines/windows/key-vault-setup.md#use-templates-to-set-up-key-vault
134134
[03]: ../policy/samples/built-in-policies.md#tags
135-
[04]: ./machine-configuration-create-test.md
136-
[05]: ./machine-configuration-create-publish.md
137-
[06]: ./machine-configuration-create-definition.md
135+
[04]: ./how-to-test-package.md
136+
[05]: ./how-to-publish-package.md
137+
[06]: ./how-to-create-policy-definition.md
138138
[07]: ../policy/assign-policy-portal.md
139139
[08]: ../policy/how-to/determine-non-compliance.md

0 commit comments

Comments
 (0)