Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation demonstrates a Windows bias by consistently using Windows-style file paths (e.g., C:\templates\main.bicep) in all examples, referencing Windows PowerShell and Azure PowerShell as primary tools, and omitting explicit Linux/macOS shell examples (e.g., Bash, sh). While Azure CLI is cross-platform, the CLI examples also use Windows paths and do not provide Linux/macOS path alternatives or notes. The documentation does not mention or show Linux-specific tools, nor does it provide parity in instructions for Linux users.
Recommendations
- Provide both Windows and Linux/macOS file path examples in all code snippets (e.g., C:\templates\main.bicep and ~/templates/main.bicep).
- Explicitly state that Azure CLI commands work on all platforms, and show Bash shell syntax (with export, $(), etc.) where appropriate.
- Add notes or tabs for Linux/macOS users, especially where file paths or environment variables differ.
- Mention and link to installation instructions for Azure CLI and PowerShell on Linux/macOS.
- Avoid assuming Windows as the default environment; use neutral language and examples where possible.
- Where PowerShell is referenced, clarify that Azure PowerShell is available cross-platform, or provide Bash equivalents for common tasks.
Create Pull Request