Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_example_in_linux_section
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all major operations, ensuring parity for Linux/macOS and Windows users. However, there are some signs of Windows bias: PowerShell examples are given equal prominence to CLI, and Windows-specific tools (e.g., Invoke-RestMethod) are mentioned for IP address retrieval. Additionally, in the PowerShell section, the Linux shell command for IP retrieval is shown, which may confuse users. There is also a reference to a Windows support article for finding your IP address.
Recommendations
- Clearly separate Linux/macOS and Windows instructions for IP address retrieval, using native tools for each (e.g., curl for Linux/macOS, PowerShell for Windows).
- In PowerShell sections, avoid showing bash commands; instead, provide PowerShell-native equivalents.
- When referencing external help articles, include links for both Windows and Linux/macOS users.
- Consider listing Azure CLI (cross-platform) examples before PowerShell (Windows-centric) examples.
- Explicitly state that Azure CLI works on Windows, Linux, and macOS, and provide installation links for all platforms.
Create Pull Request