Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples exclusively using Azure CLI and Azure PowerShell, with no Linux/macOS-specific shell examples or guidance. While Azure CLI is cross-platform, the PowerShell examples are Windows-centric and are presented alongside CLI examples in every section. There are no bash or shell script examples, nor is there mention of Linux-native tools or workflows. Additionally, PowerShell is listed as a primary tool, which may create friction for Linux/macOS users unfamiliar with it.
Recommendations
- Clarify that Azure CLI commands work natively on Linux/macOS and provide explicit bash/shell examples where appropriate.
- De-emphasize PowerShell as a primary workflow for cross-platform documentation, or provide bash equivalents for all PowerShell commands.
- Add notes or sections for Linux/macOS users, such as installation instructions for Azure CLI on those platforms.
- Where PowerShell is used for complex object manipulation, provide equivalent bash/jq or Python examples.
- Explicitly state that all operations can be performed from Linux/macOS terminals using Azure CLI.
Create Pull Request