Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates a mild Windows bias by providing detailed PowerShell instructions and references, mentioning PowerShell as a primary automation tool, and occasionally suggesting PowerShell for advanced customization (such as naming resources). PowerShell is a Windows-centric tool, and its examples and references appear before or more prominently than Azure CLI equivalents. While Azure CLI is documented and supported, PowerShell is often presented as the method for advanced scenarios, which may create friction for Linux/macOS users who prefer Bash or native CLI workflows.
Recommendations
- Ensure Azure CLI examples are equally detailed and mention customization options available via CLI, not just PowerShell.
- Avoid suggesting PowerShell as the only way to perform advanced tasks; clarify if CLI or REST API can do the same.
- Explicitly state that Azure CLI works natively on Linux/macOS and provide Bash shell usage notes where relevant.
- Where PowerShell is referenced for local installation, include parallel instructions for Bash/Azure CLI on Linux/macOS.
- Review and balance the order of examples so CLI and PowerShell are presented with equal prominence.
Create Pull Request