Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation presents PowerShell (a Windows-centric tool) examples before Azure CLI, and uses Windows-style file paths (e.g., c:\MyTemplates\azuredeploy.json) in PowerShell examples. There is no mention of Linux/macOS equivalents for PowerShell, nor are cross-platform considerations discussed for file paths or scripting environments. While Azure CLI is cross-platform and examples are provided, the ordering and PowerShell emphasis may create friction for Linux/macOS users.
Recommendations
- Present Azure CLI examples before PowerShell, as CLI is cross-platform.
- Explicitly note that PowerShell examples are for Windows and suggest using Azure CLI on Linux/macOS.
- Use platform-neutral file paths in examples (e.g., ./MyTemplates/azuredeploy.json).
- Add a note clarifying cross-platform support and recommend tools for each OS.
- Consider including Bash or shell script examples for Linux/macOS users where relevant.
Create Pull Request