Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently presenting PowerShell examples and instructions for deploying resources, with explicit references to running scripts in PowerShell locally using Visual Studio Code. While Azure CLI examples are provided (which are cross-platform), PowerShell is listed first in every code tab, and there are no explicit Linux-specific instructions, troubleshooting, or environment setup notes. There is no mention of Linux shell environments (e.g., bash, zsh), nor any guidance for Linux users regarding prerequisites or alternative tooling. The documentation also references running code in Visual Studio Code locally, which is more common in Windows-centric workflows.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to avoid implicit prioritization of Windows tools.
- Add explicit instructions and troubleshooting notes for Linux environments, including common shell prerequisites and package installation steps.
- Mention that Azure CLI is fully supported on Linux and macOS, and provide links to installation guides for those platforms.
- Include examples of running scripts in bash or zsh, and clarify that Visual Studio Code is available cross-platform.
- Add a note that all ARM template deployments can be performed from Linux, macOS, or Windows, and highlight any platform-specific considerations.
- Where screenshots or UI instructions are given, clarify that the Microsoft Entra admin center and Graph Explorer are web-based and OS-agnostic.
Create Pull Request