Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation exhibits a moderate Windows bias. File path examples consistently use Windows-style paths (e.g., C:\templates\main.bicep) without showing Linux/macOS alternatives. While both Azure PowerShell and Azure CLI are covered, PowerShell examples and references appear first in most sections, and PowerShell is a Windows-centric tool. There is no explicit mention or example of Linux/macOS file paths, shell environments, or platform-specific considerations for CLI usage. The 'Grant access' section links only to a PowerShell tutorial, omitting CLI or portal alternatives. There is a note about a known issue with PowerShell, but no guidance for Linux users. Overall, Linux/macOS users can complete the tasks, but may encounter friction due to Windows-centric patterns and lack of parity in examples.
Recommendations
- Provide Linux/macOS file path examples (e.g., /home/user/templates/main.bicep) alongside Windows paths.
- Explicitly mention that Azure CLI commands work cross-platform and note any platform-specific differences.
- Include links to CLI and portal tutorials for role assignment, not just PowerShell.
- Alternate the order of PowerShell and CLI examples, or present CLI first to reflect its cross-platform nature.
- Add notes or callouts for any platform-specific issues or workarounds, especially for Linux/macOS users.
Create Pull Request