Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation demonstrates a Windows bias in several ways: file paths are exclusively given in Windows format (e.g., C:\Templates\...), and there are no examples or notes for Linux/macOS users regarding file paths or shell differences. The CLI examples use backslashes for line continuation, which is valid in Windows CMD but not in Bash. Additionally, the documentation references PowerShell and Azure PowerShell heavily, with no mention of Bash or Linux-native shells. The only mention of a known issue is for Windows PowerShell, and there is no guidance for Linux users. The documentation does not provide Linux/macOS-specific instructions or highlight cross-platform considerations.
Recommendations
- Provide file path examples in both Windows (C:\Templates\...) and Linux/macOS (/home/user/Templates/...) formats, or use a neutral placeholder (e.g., <path-to-template>).
- Add notes or callouts for Linux/macOS users regarding differences in path separators and shell syntax.
- Use forward slashes (/) in CLI examples or provide both Windows (\) and Bash (\) line continuation examples.
- Mention Bash or other Linux-native shells alongside PowerShell, and clarify that Azure CLI commands work cross-platform.
- Where PowerShell is referenced, also mention Bash or provide equivalent Bash script snippets.
- Include troubleshooting notes or known issues for Linux/macOS users if applicable.
- Ensure screenshots and UI references are not Windows-specific, or clarify if they are the same across platforms.
Create Pull Request