Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation consistently presents Azure PowerShell (a Windows-centric tool) examples before Azure CLI examples, and provides detailed PowerShell command usage. There is an emphasis on PowerShell and Windows-specific tools and paths, with Linux and Mac paths only briefly mentioned. No Linux shell-specific examples (e.g., Bash) are provided, and the documentation assumes familiarity with Windows tools and patterns.
Recommendations
- Alternate the order of Azure CLI and PowerShell examples, or present Azure CLI (cross-platform) examples first to avoid privileging Windows users.
- Include Linux/Bash shell command examples where relevant, especially for scripting or file path manipulation.
- Provide equal detail for Linux and Mac file paths, not just a single path, and explain any differences in behavior or setup.
- Clarify that both Azure CLI and PowerShell are cross-platform, but highlight CLI as the default for Linux/macOS users.
- Add troubleshooting or setup notes specific to Linux/macOS environments, such as permissions or environment variables.
- Where possible, avoid Windows-specific terminology or explain it for non-Windows users.
Create Pull Request