Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI (bash) and PowerShell examples for every step, but PowerShell is given equal prominence to bash. There are no Linux/macOS-specific instructions or troubleshooting notes, and PowerShell is not relevant for Linux/macOS users. The examples do not mention Linux-specific shell differences or potential issues with commands like base64 encoding, which can differ between platforms. Windows tooling (PowerShell) is presented as a first-class option, which may confuse Linux users or suggest PowerShell is required.
Recommendations
- Make it clear that PowerShell examples are for Windows users, and bash/Azure CLI examples are for Linux/macOS.
- Present bash/Azure CLI examples first, with PowerShell as an alternative for Windows users.
- Add notes about platform-specific command differences (e.g., base64 encoding flags differ between GNU/Linux and macOS).
- Remove PowerShell examples from sections where they are not relevant for Linux/macOS users, or move them to a separate tab clearly labeled 'Windows/PowerShell'.
- Include troubleshooting notes for common Linux/macOS issues (e.g., permission errors, shell differences).
Create Pull Request