Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. Prerequisites and examples prioritize Windows-centric tools and workflows, such as PowerShell and ARMClient, with PowerShell instructions and references appearing before Azure CLI. The Azure CLI installation link is specifically for Windows, and there is no mention of Linux/macOS equivalents for installing Azure CLI or using ARMClient. PowerShell commands are presented first and in greater detail, while Linux/macOS-specific guidance is missing throughout.
Recommendations
- Add explicit instructions and links for installing Azure CLI on Linux and macOS, not just Windows.
- Clarify whether ARMClient is cross-platform, and if not, suggest alternatives for Linux/macOS users (e.g., curl, httpie, or native REST API usage).
- Provide example commands for Linux/macOS shells (bash/zsh), especially for file paths and environment variables.
- Balance the order of examples: present Azure CLI and REST API examples before or alongside PowerShell, not after.
- Note any platform-specific limitations or differences in tool usage.
- Where PowerShell is used, offer equivalent bash/CLI commands for Linux/macOS users.
Create Pull Request