Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples for all major operations. However, in the PowerShell sections, it recommends and demonstrates the use of ARMClient (armclient.exe), a Windows-centric tool, without mentioning Linux alternatives or cross-platform REST tools. There are no examples using curl or other standard Linux/Unix tools for REST calls, and ARMClient is presented as the default for PowerShell users, which may exclude Linux users who use PowerShell Core. This creates a subtle Windows bias in tooling recommendations and example coverage.
Recommendations
- Include examples using curl or httpie for REST operations, especially in sections where ARMClient is recommended.
- Clarify whether ARMClient works on Linux and macOS, or suggest cross-platform alternatives for PowerShell users.
- Add explicit Linux/Unix shell examples for REST calls, such as using curl, to ensure parity for non-Windows environments.
- When recommending tools, mention platform compatibility and provide installation instructions for Linux/macOS as well as Windows.
- Consider adding a 'Linux/macOS' tab alongside Azure CLI and PowerShell, or clarify that Azure CLI examples are cross-platform.
Create Pull Request