Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation generally maintains cross-platform parity by referencing both Azure CLI and Azure PowerShell for resource creation tasks. However, there is a subtle Windows bias: PowerShell is often mentioned before Azure CLI, and the 'Alternate way to get the Azure Container Instance ID' section presents the PowerShell command before the Azure CLI command. There are no Linux- or macOS-specific instructions or screenshots, and the use of PowerShell as a primary example may create friction for non-Windows users. There are no Windows-only tools or instructions, but the ordering and emphasis slightly favor Windows/PowerShell users.
Recommendations
- Alternate the order of Azure CLI and PowerShell instructions throughout the documentation, or present Azure CLI first, as it is cross-platform.
- Explicitly state that both Azure CLI and PowerShell are supported on all major platforms (Windows, Linux, macOS).
- Where possible, provide screenshots or notes relevant to Linux/macOS users (e.g., terminal examples, CLI installation guidance).
- Add a brief section or note clarifying that all command-line examples work on Linux/macOS as well as Windows, especially for Azure CLI.
- Consider including Bash shell examples for common tasks, as Cloud Shell supports Bash.
Create Pull Request