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 command examples, even in Azure CLI sections, and does not provide Linux/macOS path equivalents. This can cause confusion or friction for non-Windows users. There are no explicit Linux/macOS-specific instructions or examples, and the documentation assumes a Windows environment for file management and command usage.
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).
- Add a note clarifying that file paths should be adapted to the user's operating system.
- Explicitly mention that Azure CLI works cross-platform and show examples for Bash (Linux/macOS) and PowerShell (Windows).
- Where relevant, include instructions for running commands in Bash shells (e.g., export variables, use $HOME, etc.).
- Review references to external tutorials (e.g., role assignment) to ensure Linux/macOS parity.
Create Pull Request