Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by providing extensive Azure PowerShell examples and cmdlets, which are primarily used on Windows. PowerShell is presented as a first-class option alongside Azure CLI and portal, but there is no mention of Linux-specific tools, shell environments, or guidance for Bash users. The examples and instructions assume familiarity with PowerShell, and there are no explicit Linux or cross-platform shell examples (e.g., Bash, zsh). The documentation does not clarify that Azure CLI is fully cross-platform or provide Linux-specific troubleshooting, installation, or usage notes.
Recommendations
- Explicitly state that Azure CLI is cross-platform and provide installation instructions for Linux and macOS.
- Add Bash/zsh examples for all CLI commands, including environment variable usage and command chaining.
- Clarify that PowerShell examples are primarily for Windows users, and suggest alternatives for Linux/macOS users.
- Include troubleshooting tips or links for common Linux issues (e.g., permissions, package managers).
- Mention Linux-native tools or patterns where relevant, such as using curl for REST API calls.
- Ensure parity in example depth and coverage between PowerShell and CLI/Bash examples.
- Consider adding a section or tab for Linux/macOS users, highlighting any platform-specific considerations.
Create Pull Request