Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure PowerShell and Azure CLI examples for all major steps, but consistently lists PowerShell (a Windows-centric tool) first in each tabbed example section. The narrative also refers to opening a PowerShell terminal in Visual Studio Code before mentioning Bash, and explains PowerShell-specific features (like splatting) in detail, while not providing equivalent context for Bash/Linux users. There are no explicit Linux-only tools or patterns mentioned, and the CLI examples are present and correct, but the ordering and extra detail for PowerShell suggest a subtle Windows bias.
Recommendations
- Alternate the order of PowerShell and CLI examples, or default to CLI first, as CLI is cross-platform.
- Provide equivalent contextual explanations for Bash/Linux users (e.g., line continuation, variable usage), not just PowerShell splatting.
- Explicitly state that all commands work on Windows, macOS, and Linux, and clarify any platform-specific differences.
- Include guidance for using native Linux terminals (e.g., GNOME Terminal, xterm) in addition to Visual Studio Code.
- Where possible, add notes about using the Azure CLI in Windows Command Prompt, PowerShell, and Linux shells to reinforce parity.
Create Pull Request