Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for most steps, but PowerShell is featured as a first-class option throughout, and several code blocks use PowerShell-specific syntax (e.g., $VARIABLE assignment, [System.Text.Encoding] calls) that are not portable to Linux/macOS shells. There is no explicit mention or example of Bash, zsh, or other Linux/macOS shell environments, nor are Linux-specific instructions or troubleshooting tips provided. The use of PowerShell for environment variable assignment and token extraction is Windows-centric, and the CLI examples do not clarify cross-platform compatibility. The documentation assumes users are familiar with PowerShell, which is not standard on Linux/macOS.
Recommendations
- Add explicit Bash/zsh examples for all steps involving environment variables and token extraction, using POSIX-compliant syntax.
- Clarify that Azure CLI commands are cross-platform and provide shell-agnostic instructions where possible.
- Reorder examples so that Bash/Linux/macOS instructions are shown first or side-by-side with PowerShell, rather than PowerShell being a primary option.
- Include troubleshooting notes for Linux/macOS users, such as handling base64 decoding and file creation.
- Avoid using PowerShell-specific constructs (e.g., $VARIABLE assignment, [System.Text.Encoding]) without providing equivalent Bash alternatives.
Create Pull Request