Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
windows_tools
Summary
The documentation exhibits a 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. The examples and instructions assume a Windows environment, and there is no mention of Linux-specific considerations or alternative paths. Additionally, the only editor recommended is Visual Studio Code, which, while cross-platform, is often associated with Windows development. There is also a reference to a known issue with PowerShell on Windows, but no guidance for Linux users.
Recommendations
- Provide both Windows and Linux/macOS file path examples in all CLI and PowerShell commands (e.g., C:\templates\main.bicep and ~/templates/main.bicep).
- Explicitly state that the Azure CLI and Bicep tools are cross-platform, and provide any necessary Linux/macOS installation or usage notes.
- Include notes or tabs for Bash shell usage, especially for variable assignment and command syntax differences.
- When referencing issues or known problems, clarify if they are Windows-specific and provide Linux/macOS alternatives if available.
- Consider recommending additional cross-platform editors or tools, or clarify that Visual Studio Code is available on all major operating systems.
Create Pull Request