Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently listing PowerShell as a primary method for command-line operations, often before Azure CLI, and never mentioning Linux-specific shell usage or examples. All command-line examples are either PowerShell or Azure CLI, with no explicit Bash, Linux shell, or cross-platform scripting guidance. There are no references to Linux tools, nor any notes about platform differences or considerations for Linux users.
Recommendations
- Explicitly mention that Azure CLI commands can be run in Bash or other Linux shells, and provide example syntax for Bash (e.g., using export for environment variables, handling line continuations, etc.).
- Add notes or sections clarifying platform differences, such as how to install and use Azure CLI on Linux, and any differences in authentication or environment setup.
- Include Linux/Bash-specific examples alongside PowerShell, especially for common tasks like setting variables, piping output, or using tools like jq for JSON parsing.
- Avoid listing PowerShell before Azure CLI when presenting cross-platform options, or alternate the order to avoid implicit prioritization.
- Reference Linux-native tools where appropriate (e.g., AzCopy for Linux, or mention that manual migration can use rsync or other Linux file copy tools).
- Add a brief statement at the start of command-line sections indicating that all examples are cross-platform unless otherwise noted, and provide links to platform-specific installation guides.
Create Pull Request