README.md
This folder contains the utilities for Azure PowerShell.
Build
Common.Netcore.Dependencies.targets contains common dependencies for Azure PowerShell modules.
Test
Common.Netcore.Dependencies.Test.targets contains common dependencies of test execution for Azure PowerShell modules.
Release
Version Control
RunVersionController.ps1 bumps versions after comparing cmdlet signature between current version and snapshot of previous version. It can be executed after build
Reference Docs
CreateMappings.ps1 creates the mappings between service and cmdlet. It scans all help folders and cmdlet help files in markdown and calculates service name according to rules defined by CreateMappings_rules.json
. Output are groupMapping.json
and groupMappingWarnings.json
. It can be executed after build
.
Others
GenerateExternalContributors.ps1 generates the list of external contributors which is appended as part of release notes. It needs personal access token of Github with sufficient permission.
GenerateCmdletDesignMarkdown.ps1 generates the cmdlet signatures for review. The content bases on generated cmdlet reference docs in markdown under docs folder. You can try below code from the root folder of your module after reference doc is generated.
..\..\tools\GenerateCmdletDesignMarkdown.ps1 -Path .\docs\ -OutPath .\docs\
Cmdldet is catorized by noun, resource type name by default, with Az prefix. -NounPriority
is used to adjust the order of cmdlets in output.