Azure/azure-powershell

full scan as JSON

• Standardize PowerShell NamingApply consistent, semantic naming to generated cmdlets, parameters, and help/docs. - Cmdlet verb semantics: name sync operations with `In...

  Azure/azure-powershell Naming Conventions Markdown cloud-infra 2026-06-25

  copy raw open
• Generated Help ConsistencyWhen changing cmdlet behavior or parameter semantics, treat help/examples as generated artifacts: update the source definitions/config (c...

  Azure/azure-powershell Documentation Markdown cloud-infra 2026-07-08

  copy raw open
• Spec fidelity directivesWhen using AutoRest (or similar) to generate PowerShell/SDK surfaces, enforce that the generated cmdlets and types preserve the intended ...

  Azure/azure-powershell API Markdown cloud-infra 2026-07-10

  copy raw open
• Follow Generated NamingUse naming-and-identifier rules that match what AutoRest PowerShell generates, and make flag-style parameter typing consistent with the n...

  Azure/azure-powershell Naming Conventions Other cloud-infra 2026-06-25

  copy raw open
• Validate Security InputsApply security validation and gating at the boundaries of security-sensitive behavior: - Validate identifiers and API-version-like parame...

  Azure/azure-powershell Security C# cloud-infra 2026-07-27

  copy raw open
• Reliable Integration TestingWrite integration/recorded tests so they are deterministic, efficient in playback, and self-cleaning. Apply these rules: 1) Deterministic...

  Azure/azure-powershell Testing Other cloud-infra 2026-07-16

  copy raw open
• Null-Safe Inputs And MappingWhen a value is optional (or can differ by feature/region/constructor), never assume it’s present or non-empty. Apply consistent null/emp...

  Azure/azure-powershell Null Handling C# cloud-infra 2026-07-27

  copy raw open
• CI/CD Build Artifact RulesTreat autogenerated content as build artifacts owned by CI/CD, and handle breaking changes through the release system (not ad-hoc edits)....

  Azure/azure-powershell CI/CD Markdown cloud-infra 2026-07-24

  copy raw open
• Generated Artifacts in CITreat anything under build/generated locations (including auto-generated test stubs and generated module mirrors) as write-protected CI o...

  Azure/azure-powershell CI/CD Other cloud-infra 2026-07-24

  copy raw open
• Explicit Null Safety ChecksEnsure null-safety is precise: guard against $null *and* empty results *and* blank strings (including blank entries inside arrays/hashtab...

  Azure/azure-powershell Null Handling Other cloud-infra 2026-07-23

  copy raw open
• API versioning and client methodsWhen changing API clients, keep API versioning and HTTP operation semantics explicit and isolated. **Do** - **Scope ApiVersion changes** ...

  Azure/azure-powershell API C# cloud-infra 2026-07-16

  copy raw open
• Consistent error handlingApply a single, predictable error-handling strategy across cmdlets and SDK wrappers: - **Make existence semantics consistent**: if a meth...

  Azure/azure-powershell Error Handling C# cloud-infra 2026-07-08

  copy raw open
• Align SDK contract typesWhen updating generated PowerShell/SDK clients (e.g., AutoRest v3 → v4), treat the generated model contract as authoritative: match names...

  Azure/azure-powershell API Other cloud-infra 2026-06-25

  copy raw open
• PowerShell style hygieneAdopt consistent PowerShell coding patterns to improve correctness and readability, and keep project definitions clean. - Boolean paramet...

  Azure/azure-powershell Code Style Other cloud-infra 2026-04-03

  copy raw open
• Self-Documenting Calls & ModelsWhen reviewing code, enforce two style rules: 1) **Make complex calls self-documenting**: prefer **named arguments** over positional para...

  Azure/azure-powershell Code Style C# cloud-infra 2026-07-19

  copy raw open
• Avoid manual SDK editsWhen working on CI/CD pipelines, treat anything under `*Management.Sdk/Generated/*` (or similarly generated folders) as read-only. **Stan...

  Azure/azure-powershell CI/CD C# cloud-infra 2026-07-14

  copy raw open
• Pinned Spec ConfigurationWhen configuration files drive code generation (e.g., AutoRest README YAML), pin the exact spec snapshot and use the correct configuratio...

  Azure/azure-powershell Configurations Markdown cloud-infra 2026-07-14

  copy raw open
• Unit tests for cmdlet pathsAdd isolated unit tests for cmdlet production paths using mocked client operations. Tests must validate more than a “happy path” scenario...

  Azure/azure-powershell Testing C# cloud-infra 2026-07-16

  copy raw open
• Consistent Identifier NamingUse naming rules that keep identifiers consistent, unambiguous, and resilient to change: - Centralize repeated string keys/labels used as...

  Azure/azure-powershell Naming Conventions C# cloud-infra 2026-07-13

  copy raw open
• Generated docs truthWhen documentation or module metadata files are produced by a generator (e.g., AutoRest), treat those outputs as **generated artifacts**,...

  Azure/azure-powershell Documentation Other cloud-infra 2026-06-25

  copy raw open
• Production-Safe ConfigurationWhen changing build/test/configuration files, ensure they are (1) platform-correct and (2) production-safe. Apply this standard: 1) Platf...

  Azure/azure-powershell Configurations Yaml cloud-infra 2026-05-11

  copy raw open
• Documentation Source And ToneWhen updating documentation (assembly metadata, cmdlet HelpMessage, generated stubs, etc.), ensure (1) you change the correct source of t...

  Azure/azure-powershell Documentation C# cloud-infra 2026-04-24

  copy raw open
• Fail Fast Input ValidationValidate customer-supplied, security-relevant settings up front and fail deterministically with explicit errors when values/config combin...

  Azure/azure-powershell Security Other cloud-infra 2026-04-16

  copy raw open