About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation demonstrates a Windows bias by providing all command-line examples exclusively in PowerShell, referencing PowerShell cmdlets (e.g., New-AzResourceGroupDeployment, Set-AzureRmKeyVaultAccessPolicy) without Bash or Linux shell equivalents. There are no explicit Linux/Unix shell examples, and the use of PowerShell is presented as the default method for scripting and automation. While Azure CLI is mentioned for some vault creation steps, all automation and scripting for deployment and identity management is shown only with PowerShell, which is traditionally associated with Windows environments.
Recommendations:
- Provide equivalent Bash/Azure CLI examples for all PowerShell commands, especially for deployment and access policy steps.
- Explicitly mention that all PowerShell commands can be run cross-platform (if true), or clarify any Windows-specific requirements.
- For each PowerShell example, add a corresponding Azure CLI or Bash example, and consider presenting CLI first or side-by-side.
- Reference cross-platform tools and patterns (e.g., Azure CLI, REST API) before or alongside Windows-specific tools.
- Add a section or note for Linux/macOS users, highlighting any differences or prerequisites.
- Ensure that automation and scripting guidance is not limited to Windows/PowerShell, to support users on all platforms.
Create pull request