Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a bias towards Windows and PowerShell environments. All command-line examples are provided exclusively using Azure PowerShell, with no mention of Azure CLI or Bash alternatives that are more common on Linux and macOS. The PowerShell examples are presented as the only scripting option, and there is no guidance for Linux users on how to perform equivalent steps. The structure and ordering of examples also prioritize PowerShell over cross-platform tools.
Recommendations
- Add equivalent Azure CLI (az) examples for all PowerShell commands, including template export, modification, and deployment.
- Include Bash shell script examples where appropriate, especially for steps involving file manipulation or scripting.
- Explicitly mention that AzCopy is cross-platform and provide example commands for both Windows (cmd/PowerShell) and Linux/macOS (Bash).
- Ensure that instructions for obtaining region codes and other metadata include Azure CLI commands (e.g., az account list-locations).
- Where possible, provide guidance for Linux/macOS users, including installation and usage notes for required tools.
- Reorder examples so that cross-platform or platform-neutral options (Azure CLI, AzCopy) are presented before or alongside PowerShell.
Create Pull Request