Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is frequently referenced for troubleshooting and examples, often with detailed command-line instructions and error messages. In several cases, PowerShell commands are presented before or instead of equivalent Azure CLI commands, and troubleshooting steps are described in a Windows-centric manner (e.g., referencing 'PS C:\>' prompts). There are few, if any, explicit Linux shell examples, and no mention of Linux-specific tools or patterns. The documentation implicitly assumes familiarity with Windows/PowerShell environments, which may disadvantage Linux users.
Recommendations
- Provide equivalent Azure CLI (bash) examples alongside PowerShell commands, especially for troubleshooting and role assignment management.
- Include Linux shell (bash/zsh) command examples and error outputs where PowerShell is used, to ensure parity.
- Avoid using Windows-specific prompts (e.g., 'PS C:\>') in generic troubleshooting steps; use neutral formatting or show both Windows and Linux shell prompts.
- Explicitly mention that Azure CLI works cross-platform and provide guidance for Linux/macOS users where relevant.
- Where troubleshooting steps involve PowerShell, add parallel instructions for Azure CLI or REST API, and clarify when a solution is platform-agnostic.
Create Pull Request