Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a mild Windows bias by consistently presenting Azure PowerShell (a Windows-centric tool) examples before Azure CLI (cross-platform) examples. PowerShell is highlighted in both command and instructional sections, and the local cache path for Windows is described in more detail than for Linux/Mac. There are no Linux shell-specific examples or mentions of Linux-native tools, and the documentation assumes familiarity with Windows conventions.
Recommendations
- Alternate the order of examples so that Azure CLI (cross-platform) is presented before Azure PowerShell, or present both together without preference.
- Include Linux shell (bash) and MacOS-specific command examples where relevant, especially for file paths and environment variables.
- Provide equal detail for Linux and Mac cache paths, including example full paths (e.g., /home/<username>/.bicep/br/<registry-name>.azurecr.io/<module-path>/<tag>).
- Explicitly state that Azure CLI commands work identically on Windows, Linux, and MacOS, and encourage its use for cross-platform compatibility.
- Where PowerShell is used, clarify that it is available on Linux and Mac as well, or provide bash equivalents if possible.
Create Pull Request