azure-powershell/tools
..
AutomationTestFramework
Az
Az.Tools.Installer
Az.Tools.Predictor
AzPreview
BatchModelGenerator
BreakingChanges
BuildPackagesTask
BuildScripts
DevTools
Docker
Docs
FormatPs1XmlGenerator
Gen2Master
Github
HelpGeneration
InstallationTests
Installer
LocalFeed
ModuleMetadata
Modules
NugetAuth
ReleaseTools
ResolveTools
SecurityTools
StaticAnalysis
SwaggerCI
Test
TestFx
Tools.Common
Tools.Common.Test
VersionController
ARMIncrementVersion.ps1
ARMSyncVersion.ps1
ASMIncrementVersion.ps1
AddModulePsm1Dependency.ps1
Az.nonprod.props
AzPreview.psd1.template
AzureRM.Example.psm1
BuildDrop.ps1
BuildInstaller.ps1
CheckAssemblies.ps1
CheckIgnoredFile.ps1
CheckSignature.ps1
CleanupBuild.ps1
Common.Netcore.Dependencies.Test.targets
Common.Netcore.Dependencies.targets
CommonIncrementVersion.ps1
CompressUXMetadata.ps1
CreateAliasMapping.ps1
CreateFilterMappings.ps1
CreateMappings.ps1
CreateMappings_rules.json
CreateRegistryEntry.ps1
DeleteModules.ps1
ExecuteCIStep.ps1
ExpandModules.ps1
ExternalContributors.md
GenerateCmdletDesignMarkdown.ps1
GenerateExternalContributors.ps1
GenerateHelp.ps1
GeneratePSSwagger.ps1
GeneratedModuleList.txt
GlobalFilters.xml
ModulePublisher.psd1
ModulePublisher.psm1
NuGet.exe
PS-VSPrompt.lnk
PSRepoStart.cmd
PackModules.ps1
PipelineResultTemplate.json
PostBuildModuleAlc.ps1
PreloadToolDll.ps1
PrepareAutorestModule.ps1
PrepareForSecurityCheck.ps1
PreparePSRelease.ps1
PublishModules.ps1
PublishModules.psm1
PublishToolsModule.ps1
README.md
Repo-Tasks.psd1
Repo-Tasks.psm1
RunVersionController.ps1
SetMsiVersion.ps1
StackIncrementVersion.ps1
StackSyncVersion.ps1
SyncDocsToMicrosoftDocsOrg.ps1
SyncFromMainBranch.ps1
TestModuleLoading.ps1
TestNet472Modules.ps1
UpdateBreakingChangeDocs.ps1
UpdateChangeLog.ps1
UpdateModules.ps1
UpdateModules.psm1
UpdateNugetPackage.ps1
UpdatePlatyPS.ps1
after.Azure.PowerShell.sln.targets

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.