Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides deployment command examples for both Azure CLI and PowerShell, but PowerShell is given equal prominence despite being primarily a Windows tool. There is no mention of Bash or Linux-native scripting, and no explicit Linux-specific guidance or troubleshooting. The examples and references focus on Azure CLI (cross-platform) and PowerShell (Windows-centric), with no mention of Linux shell environments or alternative Linux tools. This may make the documentation less approachable for Linux users and reinforce a Windows-centric workflow.
Recommendations
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and provide example shell commands for Bash (e.g., using export for environment variables, or showing the same az deployment sub create command in a Linux terminal context).
- Clarify that PowerShell examples are primarily for Windows users, and suggest alternatives for Linux users (e.g., Bash, zsh).
- Add troubleshooting notes or tips for Linux environments, such as file path differences, permission issues, or installation instructions for Azure CLI on Linux.
- Consider adding a section or tab for Bash/Linux shell examples alongside PowerShell and Azure CLI, to demonstrate parity and inclusivity.
- Where references are made to Cloud Shell, clarify that it supports both Bash and PowerShell, and provide examples for both.
Create Pull Request