Apply suggestions from review

Author: michaeltlombardi

docset/winserver2022-ps/activedirectory/Add-ADCentralAccessPolicyMember.md

@@ -38,8 +38,8 @@ $params = @{
 Add-ADCentralAccessPolicyMember @params
 ```
 
-This command adds the central access rules Finance Documents Rule and Corporate Documents Rule to
-the central access policy Finance Policy.
+This command adds the central access rules `Finance Documents Rule` and `Corporate Documents Rule`
+to the central access policy Finance Policy.
 
 ### EXAMPLE 2
 
@@ -238,8 +238,7 @@ Accept wildcard characters: False
 
 ### -WhatIf
 
-Shows what would happen if the cmdlet runs.
-The cmdlet is not run.
+Shows what would happen if the cmdlet runs. The cmdlet isn't run.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

docset/winserver2022-ps/activedirectory/Add-ADComputerServiceAccount.md

@@ -40,7 +40,7 @@ account by its distinguished name, GUID, Security Identifier (SID) or Security A
 `$<localServiceAccountObject>`. If you are specifying more than one account, use a comma-separated
 list.
 
-> {!NOTE]
+> [!NOTE]
 > Adding a service account is a different operation than installing the service account locally.
 
 ## EXAMPLES
@@ -290,8 +290,7 @@ Accept wildcard characters: False
 
 ### -WhatIf
 
-Shows what would happen if the cmdlet runs.
-The cmdlet is not run.
+Shows what would happen if the cmdlet runs. The cmdlet isn't run.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

docset/winserver2022-ps/activedirectory/Add-ADDomainControllerPasswordReplicationPolicy.md

@@ -116,8 +116,7 @@ Accept wildcard characters: False
 
 ### -AuthType
 
-Specifies the authentication method to use.
-The acceptable values for this parameter are:
+Specifies the authentication method to use. The acceptable values for this parameter are:
 
 - `Negotiate` or `0`
 - `Basic` or `1`

docset/winserver2022-ps/activedirectory/Add-ADFineGrainedPasswordPolicySubject.md

@@ -87,8 +87,7 @@ name is `Fuller`.
 
 ### -AuthType
 
-Specifies the authentication method to use.
-The acceptable values for this parameter are:
+Specifies the authentication method to use. The acceptable values for this parameter are:
 
 - `Negotiate` or `0`
 - `Basic` or `1`
@@ -230,8 +229,8 @@ Accept wildcard characters: False
 
 ### -PassThru
 
-Returns an object representing the item with which you are working.
-By default, this cmdlet does not generate any output.
+Returns an object representing the item with which you are working. By default, this cmdlet does
+not generate any output.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -287,9 +286,8 @@ Accept wildcard characters: False
 
 ### -Subjects
 
-Specifies one or more users or groups.
-To specify more than one user or group, use a comma-separated list.
-You can identify a user or group by one of the following property values:
+Specifies one or more users or groups. To specify more than one user or group, use a
+comma-separated list. You can identify a user or group by one of the following property values:
 
 - Distinguished name (DN)
 - GUID (**objectGUID**)
@@ -314,8 +312,7 @@ Accept wildcard characters: False
 
 ### -WhatIf
 
-Shows what would happen if the cmdlet runs.
-The cmdlet is not run.
+Shows what would happen if the cmdlet runs. The cmdlet isn't run.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

docset/winserver2022-ps/activedirectory/Add-ADGroupMember.md

@@ -101,8 +101,7 @@ group `CN=AccountLeads,OU=UserAccounts` in the Europe domain.
 
 ### -AuthType
 
-Specifies the authentication method to use.
-The acceptable values for this parameter are:
+Specifies the authentication method to use. The acceptable values for this parameter are:
 
 - `Negotiate` or `0`
 - `Basic` or `1`
@@ -329,8 +328,8 @@ Accept wildcard characters: False
 
 ### -PassThru
 
-Returns an object representing the item with which you are working.
-By default, this cmdlet does not generate any output.
+Returns an object representing the item with which you're working. By default, this cmdlet doesn't
+generate any output.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -386,8 +385,7 @@ Accept wildcard characters: False
 
 ### -WhatIf
 
-Shows what would happen if the cmdlet runs.
-The cmdlet is not run.
+Shows what would happen if the cmdlet runs. The cmdlet isn't run.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

docset/winserver2022-ps/activedirectory/Add-ADPrincipalGroupMembership.md

@@ -54,15 +54,15 @@ property of the Active Directory directory service agent object (nTDSDSA) for th
 
 ## EXAMPLES
 
-### EXAMPLE 1
+### Example 1: Add a member to a group
 
 ```powershell
 Add-ADPrincipalGroupMembership -Identity SQLAdmin1 -MemberOf DlgtdAdminsPSOGroup
 ```
 
 This command adds the user with SAM account name `SQLAdmin1` to the group `DlgtdAdminsPSOGroup`.
 
-### EXAMPLE 2
+### Example 2: Add filtered users to a group
 
 ```powershell
 Get-ADUser -Filter 'Name -like "*SvcAccount*"' |
@@ -72,7 +72,7 @@ Get-ADUser -Filter 'Name -like "*SvcAccount*"' |
 This command gets all users with `SvcAccount` in their name and adds them to the group
 `SvcAccPSOGroup`.
 
-### EXAMPLE 3
+### Example 3: Add filtered users to a distinguished name group
 
 ```powershell
 $params = @{
@@ -91,8 +91,7 @@ This command adds all employees in `Branch1` in the AD LDS instance `localhost:6
 
 ### -AuthType
 
-Specifies the authentication method to use.
-The acceptable values for this parameter are:
+Specifies the authentication method to use. The acceptable values for this parameter are:
 
 - `Negotiate` or `0`
 - `Basic` or `1`
@@ -279,8 +278,8 @@ Accept wildcard characters: False
 
 ### -PassThru
 
-Returns an object representing the item with which you are working.
-By default, this cmdlet does not generate any output.
+Returns an object representing the item with which you're working. By default, this cmdlet doesn't
+generate any output.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -336,8 +335,7 @@ Accept wildcard characters: False
 
 ### -WhatIf
 
-Shows what would happen if the cmdlet runs.
-The cmdlet is not run.
+Shows what would happen if the cmdlet runs. The cmdlet isn't run.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

docset/winserver2022-ps/activedirectory/Add-ADResourcePropertyListMember.md

@@ -28,7 +28,7 @@ property list in Active Directory.
 
 ## EXAMPLES
 
-### EXAMPLE 1
+### Example 1: Add members to a resource property list
 
 ```powershell
 $params = @{
@@ -41,7 +41,7 @@ Add-ADResourcePropertyListMember @params
 This command adds the resource members named `Country` and `Authors` to the list named
 `Global Resource Property List`.
 
-### EXAMPLE 2
+### Example 2: Add members to a filtered resource property list
 
 ```powershell
 Get-ADResourcePropertyList -Filter "Name -like 'Corporate*'" |
@@ -56,8 +56,7 @@ and `Authors` to it.
 
 ### -AuthType
 
-Specifies the authentication method to use.
-The acceptable values for this parameter are:
+Specifies the authentication method to use. The acceptable values for this parameter are:
 
 - `Negotiate` or `0`
 - `Basic` or `1`
@@ -175,8 +174,8 @@ Accept wildcard characters: False
 
 ### -PassThru
 
-Returns an object representing the item with which you are working.
-By default, this cmdlet does not generate any output.
+Returns an object representing the item with which you're working. By default, this cmdlet doesn't
+generate any output.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

docset/winserver2022-ps/activedirectory/Clear-ADAccountExpiration.md

@@ -46,15 +46,15 @@ instance.
 
 ## EXAMPLES
 
-### EXAMPLE 1
+### Example 1: Clear an account expiration date for a specified user
 
 ```powershell
 Clear-ADAccountExpiration -Identity PattiFuller
 ```
 
 This command clears the account expiration date for the user with SamAccountName `PattiFuller`.
 
-### EXAMPLE 2
+### Example 2: Clear an account expiration date by using a distinguished name
 
 ```powershell
 Clear-ADAccountExpiration -Identity 'CN=PattiFuller,DC=AppNC' -Server 'PATTIFU-SVR1:60000'
@@ -67,8 +67,7 @@ This command clears the account expiration date for the user with DistinguishedN
 
 ### -AuthType
 
-Specifies the authentication method to use.
-The acceptable values for this parameter are:
+Specifies the authentication method to use. The acceptable values for this parameter are:
 
 - `Negotiate` or `0`
 - `Basic` or `1`
@@ -217,8 +216,8 @@ Accept wildcard characters: False
 
 ### -PassThru
 
-Returns an object representing the item with which you are working.
-By default, this cmdlet does not generate any output.
+Returns an object representing the item with which you're working. By default, this cmdlet doesn't
+generate any output.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -274,8 +273,7 @@ Accept wildcard characters: False
 
 ### -WhatIf
 
-Shows what would happen if the cmdlet runs.
-The cmdlet is not run.
+Shows what would happen if the cmdlet runs. The cmdlet isn't run.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

docset/winserver2022-ps/activedirectory/Clear-ADClaimTransformLink.md

@@ -30,15 +30,15 @@ more cross-forest trust relationships in Active Directory.
 
 ## EXAMPLES
 
-### EXAMPLE 1
+### Example 1: Remove a specified policy from a trust relationship
 
 ```powershell
 Clear-ADClaimTransformLink -Identity 'corp.contoso.com' -Policy DenyAllPolicy
 ```
 
 This command removes the policy named `DenyAllPolicy` from the `corp.contoso.com` trust.
 
-### EXAMPLE 2
+### Example 2: Remove all policies that are applied to a trusted forest
 
 ```powershell
 Clear-ADClaimTransformLink -Identity 'corp.contoso.com' -TrustRole Trusted
@@ -48,7 +48,7 @@ This command removes any policies that are applied to where this forest acts as
 in the `corp.contoso.com` trust. Effectively, this cmdlet removes any policies that are applied to
 claims flowing out of this forest towards it trust partner.
 
-### EXAMPLE 3
+### Example 3: Remove a claim transformation policy from being applied to the trust relationship
 
 ```powershell
 $params = @{
@@ -67,8 +67,7 @@ claims coming into this from its trust partner.
 
 ### -AuthType
 
-Specifies the authentication method to use.
-The acceptable values for this parameter are:
+Specifies the authentication method to use. The acceptable values for this parameter are:
 
 - `Negotiate` or `0`
 - `Basic` or `1`
@@ -161,8 +160,8 @@ Accept wildcard characters: False
 
 ### -PassThru
 
-Returns an object representing the item with which you are working.
-By default, this cmdlet does not generate any output.
+Returns an object representing the item with which you're working. By default, this cmdlet doesn't
+generate any output.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -255,8 +254,7 @@ Accept wildcard characters: False
 
 ### -WhatIf
 
-Shows what would happen if the cmdlet runs.
-The cmdlet is not run.
+Shows what would happen if the cmdlet runs. The cmdlet isn't run.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter

docset/winserver2022-ps/activedirectory/Disable-ADAccount.md

@@ -46,15 +46,15 @@ instance.
 
 ## EXAMPLES
 
-### EXAMPLE 1
+### Example 1: Disable an account by identity
 
 ```powershell
 Disable-ADAccount -Identity PattiFul
 ```
 
 This command disables the account with identity SAMAccountName `PattiFul`.
 
-### EXAMPLE 2
+### Example 2: Disable an account by Distinguished Name
 
 ```powershell
 Disable-ADAccount -Identity 'CN=Patti Fuller,OU=Finance,OU=Users,DC=FABRIKAM,DC=COM'
@@ -63,7 +63,7 @@ Disable-ADAccount -Identity 'CN=Patti Fuller,OU=Finance,OU=Users,DC=FABRIKAM,DC=
 This command disables the account with DistinguishedName
 `CN=Patti Fuller,OU=Finance,OU=Users,DC=FABRIKAM,DC=COM`.
 
-### EXAMPLE 3
+### Example 3: Disable all accounts in an organizational unit
 
 ```powershell
 Get-ADUser -Filter 'Name -like "*"' -SearchBase "OU=Finance,OU=Users,DC=FABRIKAM,DC=COM" |
@@ -77,8 +77,7 @@ This command disables all accounts in the organizational unit
 
 ### -AuthType
 
-Specifies the authentication method to use.
-The acceptable values for this parameter are:
+Specifies the authentication method to use. The acceptable values for this parameter are:
 
 - `Negotiate` or `0`
 - `Basic` or `1`
@@ -227,8 +226,8 @@ Accept wildcard characters: False
 
 ### -PassThru
 
-Returns an object representing the item with which you are working.
-By default, this cmdlet does not generate any output.
+Returns an object representing the item with which you're working. By default, this cmdlet doesn't
+generate any output.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -284,8 +283,7 @@ Accept wildcard characters: False
 
 ### -WhatIf
 
-Shows what would happen if the cmdlet runs.
-The cmdlet is not run.
+Shows what would happen if the cmdlet runs. The cmdlet isn't run.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter