Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a Windows bias by presenting the PowerShell example before the Azure CLI example in the 'Set deployment mode' section. PowerShell is a Windows-centric tool, and its precedence over Azure CLI (which is cross-platform and more commonly used on Linux/macOS) suggests a Windows-first approach. Additionally, there are no explicit Linux shell (e.g., Bash) or platform-agnostic deployment examples, nor is there mention of Linux-specific considerations or tools. The documentation also references file paths in a Windows format (e.g., c:\MyTemplates\storage.json) in the PowerShell example, further reinforcing the Windows bias.
Recommendations
- Present Azure CLI examples before PowerShell examples, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Include Bash shell script examples or at least clarify that Azure CLI commands work on Linux/macOS terminals.
- Use platform-neutral file paths in examples (e.g., ./MyTemplates/storage.json) or provide both Windows and Linux path formats.
- Explicitly mention that both Azure CLI and PowerShell are supported on all major platforms, and link to guidance for Linux/macOS users.
- Consider adding a short section or note for Linux/macOS users to ensure parity and inclusivity.
Create Pull Request