Bias Analysis
Detected Bias Types
bash_first
windows_shell_notes
windows_shell_formatting
Summary
The documentation page primarily presents Azure CLI examples using Bash syntax and notes that adjustments are needed for Windows PowerShell or Command Prompt. It provides some guidance for Windows shell users (cmd/PowerShell) on parameter formatting, but all code samples are Bash-first, with Windows-specific instructions relegated to explanatory text. There are no full PowerShell/cmd examples, and Linux is referenced only in passing (e.g., cloud-init for Linux VMs).
Recommendations
- Provide full PowerShell and Command Prompt examples alongside Bash samples, especially for parameter passing and variable usage.
- Clearly label each example with the intended shell/platform.
- Add a dedicated section for Windows shell users, outlining common differences and pitfalls.
- Ensure parity in explanations for both Linux/macOS and Windows environments, including file path formats and quoting/escaping rules.
- Consider including macOS-specific notes if there are any platform-specific caveats.
Create Pull Request