Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by prioritizing Windows-centric tools and instructions. PowerShell is featured first and in greater detail, with prerequisite steps focused on Azure PowerShell and Windows installation links. ARMClient, a Windows-oriented tool, is recommended without Linux alternatives. The Azure CLI section references Windows installation first and does not provide explicit Linux/macOS installation guidance. There are no Linux-specific examples, shell commands, or notes on cross-platform usage, and PowerShell commands are used to obtain information even in CLI sections.
Recommendations
- Add explicit instructions and examples for Linux and macOS environments, including installation links for Azure CLI and PowerShell on those platforms.
- Include bash/zsh shell command examples alongside PowerShell, especially for resource group and policy management.
- Mention cross-platform compatibility for ARMClient or suggest alternative tools (e.g., curl, httpie) that are native to Linux/macOS.
- Reorder sections to present Azure CLI and REST API examples before PowerShell to avoid Windows-first perception.
- Clarify that all tools (Azure CLI, PowerShell) are available on Linux/macOS and provide relevant links.
- Avoid using PowerShell commands in CLI-focused sections; use CLI-native commands to retrieve information.
Create Pull Request