Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation consistently uses Windows-style file paths (e.g., C:\templates\main.bicep) in all CLI and PowerShell examples, without providing Linux/macOS equivalents. All command examples reference these Windows paths, and there is no mention of Linux/macOS file path syntax or usage. Additionally, the only editor mentioned is Visual Studio Code, which is cross-platform, but the documentation does not clarify file path differences or provide explicit Linux/macOS instructions. There is a note about a known issue with PowerShell, but no Linux-specific caveats or guidance.
Recommendations
- Provide Linux/macOS file path examples (e.g., /home/user/templates/main.bicep) alongside Windows examples in all CLI and PowerShell commands.
- Add a note or section explaining file path differences between Windows and Linux/macOS, and how to adapt commands accordingly.
- Explicitly state that both Azure CLI and PowerShell are cross-platform, and clarify any OS-specific behaviors or issues.
- Where possible, use environment variables or relative paths in examples to increase portability.
- Include troubleshooting tips for Linux/macOS users if any commands behave differently.
Create Pull Request