Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation exhibits Windows bias by consistently using Windows-style file paths (e.g., C:\templates\main.bicep) in all CLI and PowerShell examples, without providing Linux/macOS equivalents. All command examples assume a Windows environment, and there is no mention of Linux-specific patterns, such as using forward slashes in file paths or handling environment variables in Bash. The documentation also references Windows tools (PowerShell) and links to PowerShell-based tutorials for access control, without offering Bash or Linux alternatives.
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.
- Explicitly mention cross-platform compatibility of Azure CLI and PowerShell, and note any platform-specific caveats.
- Where PowerShell is referenced for role assignments or other tasks, include equivalent Bash/Azure CLI instructions.
- Add notes or tabs for Linux/macOS users, especially for steps involving file paths, environment variables, or shell scripting.
- Ensure all command snippets and explanations are clear about platform differences, and avoid assuming a Windows-only environment.
Create Pull Request