Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation exhibits mild Windows bias by consistently using Windows-style file paths (e.g., C:\templates\main.bicep) in all command examples, regardless of shell or platform. There are no explicit Linux/macOS examples for file paths, and Windows PowerShell is mentioned in notes and prerequisites before Linux alternatives. The only role assignment tutorial linked is PowerShell-specific, with no CLI or Linux-native alternative. However, Azure CLI is provided throughout, and most commands are cross-platform.
Recommendations
- Provide Linux/macOS file path examples (e.g., ~/templates/main.bicep or /home/user/templates/main.bicep) alongside Windows paths in all CLI and PowerShell command samples.
- Add explicit notes clarifying path differences between platforms.
- Include links to role assignment tutorials using Azure CLI, not just PowerShell.
- Mention that both Azure CLI and PowerShell are cross-platform, and clarify any platform-specific issues (such as variable assignment differences).
- When referencing tools, avoid implying Windows as the default (e.g., avoid only showing Windows install links or instructions).
Create Pull Request