Bias Analysis
Detected Bias Types
windows_first
windows_tools
Summary
The documentation page exhibits mild Windows bias by mentioning Windows-centric tools and patterns before their Linux equivalents. Specifically, in the 'environment' function section, the documentation references both 'az cloud list' (cross-platform Azure CLI) and 'Get-AzEnvironment' (PowerShell cmdlet), but lists the Azure CLI command first. However, the PowerShell cmdlet is Windows-focused and could be perceived as giving Windows users special attention. No explicit Linux-only examples or tools are provided, and there are no examples of running Bicep deployments from Linux environments or shell scripts.
Recommendations
- Ensure parity by providing explicit Linux shell examples (e.g., Bash) for querying Azure environments, such as using 'az cloud list' in a Linux terminal.
- Clarify that Azure CLI is cross-platform and can be used on Windows, Linux, and macOS.
- Avoid referencing PowerShell-specific cmdlets unless also providing equivalent Linux-native commands or scripts.
- Consider including a section or note about running Bicep deployments from Linux environments, with sample commands.
- Review all tool references to ensure Linux and macOS users are equally supported and represented.
Create Pull Request