Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates a Windows bias in several ways. PowerShell is presented first and more prominently than Azure CLI for building Bicep files, and there are no explicit Linux or macOS-specific instructions or examples. The use of Visual Studio Code is platform-neutral, but the lack of mention of Linux-specific tools, shell environments, or alternative editors further reinforces a Windows-centric approach. Portal instructions are platform-agnostic, but command-line examples and tool recommendations favor Windows users.
Recommendations
- Present Azure CLI examples before or alongside PowerShell examples, as Azure CLI is cross-platform.
- Explicitly mention that all CLI commands work on Linux, macOS, and Windows, and provide shell-specific instructions where relevant.
- Include Linux/macOS-specific notes or screenshots where UI or tool behavior may differ.
- Recommend alternative editors (e.g., Vim, nano) for users who may not use Visual Studio Code.
- Add a section or callout for Linux users, highlighting any differences in setup or usage.
- Where PowerShell is referenced, clarify that Azure CLI is equally supported and may be preferred on non-Windows platforms.
Create Pull Request