Author: SebastianSchuetze

.docs/Add-VSTeamGitRepositoryPermission.md

@@ -64,55 +64,71 @@ This example grants read and contribute permissions to the "release" branch of t
 
 ### RepositoryId
 
+ID of the repository for which the permissions are to be set.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### RepositoryName
 
+Name of the repository for which the permissions are to be set.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### BranchName
 
+Name of the branch for which the permissions are to be set.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### Descriptor
 
+Descriptor of the user or group for which the permissions are to be set.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### User
 
+User descriptor for which the permissions are to be set.
+
 ```yaml
 Type: VSTeamUser
 Required: True
 ```
 
 ### Group
 
+Group descriptor for which the permissions are to be set.
+
 ```yaml
 Type: VSTeamGroup
 Required: True
 ```
 
 ### Allow
 
+Allow permissions to be set.
+
 ```yaml
 Type: VSTeamGitRepositoryPermissions
 Required: True
 ```
 
 ### Deny
 
+Deny permissions to be set.
+
 ```yaml
 Type: VSTeamGitRepositoryPermissions
 Required: True

.docs/Add-VSTeamProfile.md

@@ -38,24 +38,7 @@ On Windows, allows you use to use Windows authentication against a local TFS ser
 
 ## PARAMETERS
 
-### Account
-
-The Azure DevOps (AzD) account name to use.
-DO NOT enter the entire URL.
-
-Just the portion after dev.azure.com. For example in the
-following url mydemos is the account name.
-<https://dev.azure.com/mydemos>
-or
-The full Team Foundation Server (TFS) url including the collection.
-<http://localhost:8080/tfs/DefaultCollection>
-
-```yaml
-Type: String
-Parameter Sets: Secure, Plain, Windows
-Required: True
-Position: 1
-```
+<!-- #include "./params/account.md" -->
 
 ### SecurePersonalAccessToken
 

.docs/Add-VSTeamProjectPermission.md

@@ -66,34 +66,44 @@ This command allows the user "robert.jones@example.net" to "EditDesigns" and den
 
 ### Descriptor
 
+Descriptor of the user or group to add permissions for.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### User
 
+User descriptor to add permissions for.
+
 ```yaml
 Type: VSTeamUser
 Required: True
 ```
 
 ### Group
 
+Group descriptor to add permissions for.
+
 ```yaml
 Type: VSTeamGroup
 Required: True
 ```
 
 ### Allow
 
+Allow permissions to add.
+
 ```yaml
 Type: VSTeamProjectPermissions
 Required: True
 ```
 
 ### Deny
 
+Deny permissions to add.
+
 ```yaml
 Type: VSTeamProjectPermissions
 Required: True

.docs/Add-VSTeamWorkItemAreaPermission.md

@@ -62,48 +62,62 @@ This command prompts for confirmation before adding read and write permissions a
 
 ### AreaID
 
+Area ID of the work item area for which the permissions are to be set.
+
 ```yaml
 Type: Int32
 Required: True
 ```
 
 ### AreaPath
 
+Area path of the work item area for which the permissions are to be set.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### Descriptor
 
+Descriptor of the user or group to add permissions for.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### User
 
+User descriptor to add permissions for.
+
 ```yaml
 Type: VSTeamUser
 Required: True
 ```
 
 ### Group
 
+Group descriptor to add permissions for.
+
 ```yaml
 Type: VSTeamGroup
 Required: True
 ```
 
 ### Allow
 
+Allow permissions to add.
+
 ```yaml
 Type: VSTeamWorkItemAreaPermissions
 Required: True
 ```
 
 ### Deny
 
+Deny permissions to add.
+
 ```yaml
 Type: VSTeamWorkItemAreaPermissions
 Required: True

.docs/Add-VSTeamWorkItemIterationPermission.md

@@ -67,48 +67,62 @@ This command prompts for confirmation before adding read and write permissions a
 
 ### IterationID
 
+Iteration ID for which the permissions are to be set.
+
 ```yaml
 Type: Int32
 Required: True
 ```
 
 ### IterationPath
 
+Iteration path for which the permissions are to be set.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### Descriptor
 
+Descriptor of the user or group to add permissions for.
+
 ```yaml
 Type: String
 Required: True
 ```
 
 ### User
 
+User descriptor to add permissions for.
+
 ```yaml
 Type: VSTeamUser
 Required: True
 ```
 
 ### Group
 
+Group descriptor to add permissions for.
+
 ```yaml
 Type: VSTeamGroup
 Required: True
 ```
 
 ### Allow
 
+Allow permissions to add.
+
 ```yaml
 Type: VSTeamWorkItemIterationPermissions
 Required: True
 ```
 
 ### Deny
 
+Deny permissions to add.
+
 ```yaml
 Type: VSTeamWorkItemIterationPermissions
 Required: True

.docs/Get-VSTeamAgentPoolMaintenance.md

@@ -0,0 +1,48 @@
+<!-- #include "./common/header.md" -->
+
+# Get-VSTeamAgentPoolMaintenance
+
+## SYNOPSIS
+
+Gets the agent pool maintenance job
+
+## SYNTAX
+
+## DESCRIPTION
+
+Gets the agent pool maintenance job
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Get-VSTeamAgentPoolMaintenance -Id 1
+```
+
+Gets the agent pool maintenance job with id 1
+
+## PARAMETERS
+
+### Id
+Id of the pool to maintain
+
+```yaml
+Type: Int32
+Parameter Sets: (All)
+Aliases: PoolID
+Required: True
+```
+
+<!-- #include "./params/projectName.md" -->
+
+## INPUTS
+
+## OUTPUTS
+
+### System.Object
+
+## NOTES
+
+<!-- #include "./common/prerequisites.md" -->
+
+## RELATED LINKS

.docs/Get-VSTeamPullRequest.md

@@ -176,6 +176,8 @@ Type: Switch
 Parameter Sets: IncludeCommits
 ```
 
+<!-- #include "./params/projectName.md" -->
+
 ## INPUTS
 
 ## OUTPUTS

.docs/Get-VSTeamRelease.md

@@ -114,34 +114,44 @@ Default value: 0
 
 ### CreatedBy
 
+Creator of the release.
+
 ```yaml
 Type: String
 Parameter Sets: List
 ```
 
 ### MinCreatedTime
 
+Minimum creation time of releases to be returned.
+
 ```yaml
 Type: DateTime
 Parameter Sets: List
 ```
 
 ### MaxCreatedTime
 
+Maximum creation time of releases to be returned.
+
 ```yaml
 Type: DateTime
 Parameter Sets: List
 ```
 
 ### QueryOrder
 
+Order of the results.
+
 ```yaml
 Type: String
 Parameter Sets: List
 ```
 
 ### ContinuationToken
 
+ContinuationToken is used when retrieving more results than can be returned in one response.
+
 ```yaml
 Type: String
 Parameter Sets: List

.docs/Set-VSTeamAccount.md

@@ -80,24 +80,7 @@ Will add the account and use the OAuth Token provided by AzD when you check the
 
 ## PARAMETERS
 
-### Account
-
-The Azure DevOps (AzD) account name to use.
-DO NOT enter the entire URL.
-
-Just the portion after dev.azure.com. For example in the
-following url mydemos is the account name.
-<https://dev.azure.com/mydemos>
-or
-The full Team Foundation Server (TFS) url including the collection.
-<http://localhost:8080/tfs/DefaultCollection>
-
-```yaml
-Type: String
-Parameter Sets: Secure, Plain, Windows
-Required: True
-Position: 1
-```
+<!-- #include "./params/account.md" -->
 
 ### SecurePersonalAccessToken