Address comments.

blarrywang · blarrywang · commit a80a1a2e5683 · 2025-08-14T11:12:10.000-07:00
diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md
@@ -14,7 +14,7 @@ manager: yigitd
 # Get-SPOSiteManageVersionPolicyJobProgress
 
 ## SYNOPSIS
-Gets the status and progress for background jobs started by `New-SPOSiteManageVersionPolicyJob`.
+Gets the status and progress for a background job started by `New-SPOSiteManageVersionPolicyJob`.
 > [!NOTE]
 > This feature is currently in preview and may not be available in your tenant.
 
@@ -25,7 +25,7 @@ Get-SPOSiteManageVersionPolicyJobProgress [-Identity] <SpoSitePipeBind> [<Common
 ```
 
 ## DESCRIPTION
-Gets the status and progress for background jobs started by `New-SPOSiteManageVersionPolicyJob`.
+Gets the status and progress for a background job started by `New-SPOSiteManageVersionPolicyJob`.
 
 ## EXAMPLES
 
@@ -35,7 +35,7 @@ Gets the status and progress for background jobs started by `New-SPOSiteManageVe
 Get-SPOSiteManageVersionPolicyJobProgress https://contoso.sharepoint.com/sites/site1
 ```
 
-Gets the progress of the site manage version policy job for the site.
+Gets the progress of the site manage version policy job for the given site.
 
 ## PARAMETERS
 
diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md
@@ -463,7 +463,7 @@ Generates a version storage usage report for a site collection. This report can
 Creates a new group in a SharePoint Online site collection.
 
 ### [New-SPOSiteManageVersionPolicyJob](New-SPOSiteManageVersionPolicyJob.md)
-Starts a background job that manages the file versions and version history limits of all of its document libraries.
+Starts a background job to manage file versions and version history limits for all document libraries in the given site.
 
 ### [New-SPOSiteSharingReportJob](New-SPOSiteSharingReportJob.md)
 Creates a new sharing report job.
@@ -565,7 +565,7 @@ Stops further processing of site level trim job that is in-progress.
 Removes a SharePoint Online group from a site collection.
 
 ### [Remove-SPOSiteManageVersionPolicyJob](Remove-SPOSiteManageVersionPolicyJob.md)
-Stops further processing of site manage version policy job that is in-progress.
+Stops processing of the in-progress manage version policy job for the given site.
 
 ### [Remove-SPOSiteScript](Remove-SPOSiteScript.md)
 Removes a site script.
diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md
@@ -167,17 +167,10 @@ Accept wildcard characters: False
 
 ### -FileTypes
 An array of file type names to trim versions. The supported file type names are:
-
 - Audio
-
 - OutlookPST
-
 - Video
 
-
-
-- 
-
 ```yaml
 Type: String[]
 Parameter Sets: ByPolicy
@@ -272,10 +265,6 @@ Accept wildcard characters: False
 ### -TrimUseListPolicy
 Indicates whether to trim versions by applying the document library's version history limits.
 
-
-
-
-
 ```yaml
 Type: SwitchParameter
 Parameter Sets: ByPolicy
diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md
@@ -14,7 +14,7 @@ manager: yigitd
 # New-SPOSiteManageVersionPolicyJob
 
 ## SYNOPSIS
-Starts a background job that manages the file versions and version history limits of all of its document libraries.
+Starts a background job to manage file versions and version history limits for all document libraries in the given site.
 
 > [!NOTE]
 > This feature is currently in preview and may not be available in your tenant.
diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md
@@ -14,7 +14,7 @@ manager: yigitd
 # Remove-SPOSiteManageVersionPolicyJob
 
 ## SYNOPSIS
-Stops further processing of site manage version policy job that is in-progress.
+Stops processing of the in-progress manage version policy job for the given site.
 
 > [!NOTE]
 > This feature is currently in preview and may not be available in your tenant.
@@ -26,7 +26,7 @@ Remove-SPOSiteManageVersionPolicyJob [-Identity] <SpoSitePipeBind> [-WhatIf] [-C
 ```
 
 ## DESCRIPTION
-Stops further processing of site manage version policy job that is in-progress.
+Stops processing of the in-progress manage version policy job for the given site.
 
 ## EXAMPLES
 
diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md
@@ -216,24 +216,16 @@ Accept wildcard characters: False
 > Applicable: SharePoint Online
 
 An array of file type names. The supported file type names are:
-
 - Audio
-
 - OutlookPST
-
 - Video
 
 Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: 
+- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim)
+- [MajorVersionLimit](#-MajorVersionLimit)
+- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays)
 
-- EnableAutoExpirationVersionTrim
-
-- MajorVersionLimit
-
-- ExpireVersionsAfterDays
-
-Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the **Sync** parameter. For more information about this option, please refer to the documentation for the **Sync** parameter.
-
-
+Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the [Sync](#-Sync) parameter. For more information about this option, please refer to the documentation for the [Sync](#-Sync) parameter.
 
 ```yaml
 Type: String[]
@@ -340,15 +332,10 @@ Accept wildcard characters: False
 Apply the version history limits of the tenant or the site (if the site this document library is in has broken inheritance for version history limits).
 
 You may use the following parameters in combination to update only the default policy or a set of file type overrides:
-
-- ExcludeDefaultPolicy: if set, it will not update the default policy.
-
-- FileTypes: 
-
+- [ExcludeDefaultPolicy](#-ExcludeDefaultPolicy): if set, it will not update the default policy.
+- [FileTypes](#-FileTypes): 
   - if set, it will update the specified file types; 
-    
   - if not set, it will update all file type overrides;
-    
   - if set to an empty array (i.e. `@()`), it will not update any file type overrides.
     
 > [!NOTE]
diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md
@@ -149,14 +149,12 @@ Set-SPOSite [-Identity] <SpoSitePipeBind> [-InformationBarriersMode <String>]
 
 ### SetSiteFileTypeFileVersionPolicy
 
-
 ```
 Set-SPOSite [-Identity] <SpoSitePipeBind> [-InformationBarriersMode <String>] [-EnableAutoExpirationVersionTrim <Boolean>] [-ExpireVersionsAfterDays <Int32>] [-MajorVersionLimit <Int32>] -FileTypesForVersionExpiration <String[]> [-ApplyToNewDocumentLibraries] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### RemoveSiteFileVersionPolicy
 
-
 ```
 Set-SPOSite [-Identity] <SpoSitePipeBind> [-InformationBarriersMode <String>] [-ApplyToNewDocumentLibraries]
  [-RemoveVersionExpirationFileTypeOverride <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
@@ -273,47 +271,47 @@ In this example, an authentication context called MFA is attached to the site.
 Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $true
 ```
 
-Example 11 sets automatic version history limits at site level. Automatic setting will be applied to all new document libraries created in the site and a background request will be created to asynchronously process the update on existing document libraries that have versioning enabled.
+Example 11 sets automatic version history limits at the site level. Automatic setting will be applied to all new document libraries created in the site and a background request will be created to asynchronously process the update on existing document libraries that have versioning enabled.
 
 ### EXAMPLE 12
 
 ```powershell
 Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 30
 ```
 
-Example 12 sets manual version history limits at site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. Also it creates a job to set this manual version setting for existing document libraries that enabled versioning.
+Example 12 sets manual version history limits at the site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. Also it creates a job to set this manual version setting for existing document libraries that enabled versioning.
 
 ### EXAMPLE 13
 
 ```powershell
 Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 0
 ```
 
-Example 13 sets manual version history limits at site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. Also it creates a job to set this manual version setting for existing document libraries that enabled versioning.
+Example 13 sets manual version history limits at the site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. Also it creates a job to set this manual version setting for existing document libraries that enabled versioning.
 
 ### Example 14
 
 ```powershell
 Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $true -ApplyToNewDocumentLibraries
 ```
 
-Example 14 sets automatic version history limits at site level. The new document libraries will use this version setting.
+Example 14 sets automatic version history limits at the site level. The new document libraries will use this version setting.
 
 ### EXAMPLE 15
 
 ```powershell
 Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -ExpireVersionsAfterDays 30 -ApplyToNewDocumentLibraries
 ```
 
-Example 15 sets manual version history limits at site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting.
+Example 15 sets manual version history limits at the site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting.
 
 ### EXAMPLE 16
 
 ```powershell
 Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -ExpireVersionsAfterDays 0 -ApplyToNewDocumentLibraries
 ```
 
-Example 16 sets manual version history limits at site level by limiting the number of versions with no time limits. The new document libraries will use this version setting.
+Example 16 sets manual version history limits at the site level by limiting the number of versions with no time limits. The new document libraries will use this version setting.
 
 ### Example 17
 
@@ -345,7 +343,7 @@ Example 19 creates a request to set manual version history limits that limits th
 Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -InheritVersionPolicyFromTenant
 ```
 
-Example 20 clears the file version setting at site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries.
+Example 20 clears the file version setting at the site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries.
 
 ### Example 21
 
@@ -354,7 +352,7 @@ Example 20 clears the file version setting at site level. The new document libra
 Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $true -FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries
 ```
 
-Example 21 sets automatic version history limit override for video and audio file types at site level. The new document libraries will use this version setting.
+Example 21 sets automatic version history limit override for video and audio file types at the site level. The new document libraries will use this version setting.
 
 ### Example 22
 
@@ -364,7 +362,7 @@ Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpi
 -FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries
 ```
 
-Example 22 sets manual version history limit override for video and audio file types at site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting.
+Example 22 sets manual version history limit override for video and audio file types at the site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting.
 
 ### Example 23
 
@@ -374,7 +372,7 @@ Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpi
 -FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries
 ```
 
-Example 23 sets manual version history limit override for video and audio file types at site level by limiting the number of versions with no time limits. The new document libraries will use this version setting.
+Example 23 sets manual version history limit override for video and audio file types at the site level by limiting the number of versions with no time limits. The new document libraries will use this version setting.
 
 ### Example 24
 
@@ -581,8 +579,7 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-
-```
+```yaml
 Type: SwitchParameter
 Parameter Sets: SetSiteFileTypeFileVersionPolicy
 Aliases:
@@ -1241,27 +1238,18 @@ Accept wildcard characters: False
 > Applicable: SharePoint Online
 
 An array of file type names. The supported file type names are:
-
 - Audio
-
 - OutlookPST
-
 - Video
 
 Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: 
+- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim)
+- [MajorVersionLimit](#-MajorVersionLimit)
+- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays)
 
-- EnableAutoExpirationVersionTrim
-
-- MajorVersionLimit
+This must be used with [ApplyToNewDocumentLibraries](#-ApplyToNewDocumentLibraries) switch set to true, because the version history limits are only applied on new document libraries in the site.
 
-- ExpireVersionsAfterDays
-
-This must be used with **ApplyToNewDocumentLibraries** switch set to true, because the version history limits are only applied on new document libraries in the site.
-
-
-
-
-```
+```yaml
 Type: String[]
 Parameter Sets: SetSiteFileTypeFileVersionPolicy
 Aliases:
@@ -1375,7 +1363,7 @@ Accept wildcard characters: False
 
 > Applicable: SharePoint Online
 
-Clear the file version setting at site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries.
+Clear the file version setting at the site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries.
 
 ```yaml
 Type: System.Management.Automation.SwitchParameter
@@ -1810,12 +1798,11 @@ Accept wildcard characters: False
 
 An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. 
 
-This must be used with **ApplyToNewDocumentLibraries** switch set to true, because the version history limits are only applied on new document libraries in the site.
+This must be used with [ApplyToNewDocumentLibraries](#-ApplyToNewDocumentLibraries) switch set to true, because the version history limits are only applied on new document libraries in the site.
 
 > [!NOTE]
 > This feature is currently in preview and may not be available in your tenant.
 
-
 ```yaml
 Type: String[]
 Parameter Sets: RemoveSiteFileVersionPolicy
diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md
@@ -3170,27 +3170,20 @@ Accept wildcard characters: False
 ### -FileTypesForVersionExpiration
 
 An array of file type names. The supported file type names are:
-
 - Audio
-
 - OutlookPST
-
 - Video
 
 Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: 
-
-- EnableAutoExpirationVersionTrim
-
-- MajorVersionLimit
-
-- ExpireVersionsAfterDays
+- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim)
+- [MajorVersionLimit](#-MajorVersionLimit)
+- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays)
 
 The version history limits are applied on new document libraries in the tenant.
 
 > [!NOTE]
 > This feature is currently in preview and may not be available in your tenant.
 
-
 ```yaml
 Type: String[]
 Parameter Sets: (All)
@@ -4521,10 +4514,7 @@ The version history limits are applied on new document libraries in the tenant.
 > [!NOTE]
 > This feature is currently in preview and may not be available in your tenant.
 
-YAML
-
-
-```
+```yaml
 Type: String[]
 Parameter Sets: (All)
 Aliases:
