Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation consistently presents Windows-centric tools (Azure Portal and PowerShell) before cross-platform alternatives (Azure CLI). PowerShell examples are detailed and prominent, while Azure CLI examples are present but less emphasized. There are no Linux-specific instructions, and the ordering and depth of examples may create friction for Linux/macOS users.
Recommendations
- Present Azure CLI examples before or alongside PowerShell examples, as CLI is cross-platform.
- Ensure CLI examples are as detailed as PowerShell ones, including optional parameters and advanced scenarios.
- Explicitly mention that Azure CLI and Portal are fully supported on Linux/macOS, and clarify any OS-specific limitations.
- Add notes or sections for Linux/macOS users where relevant, such as installation or environment setup.
- Avoid language that implies PowerShell is the default or preferred method unless justified by functionality.
Create Pull Request