Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides extensive PowerShell examples and instructions, which are primarily relevant to Windows users. PowerShell is featured prominently and in detail, sometimes before Azure CLI examples. File paths in PowerShell examples use Windows-style (C:\temp\json.txt), and there is no mention of Linux shell equivalents (e.g., Bash scripting, Linux file paths). There are no examples using Bash, nor references to Linux-specific tooling or patterns. The documentation assumes familiarity with PowerShell and Windows conventions, which may disadvantage Linux users.
Recommendations
- Add Bash shell script examples for all Azure CLI workflows, including file operations and JSON manipulation, using Linux-style paths (e.g., /tmp/json.txt).
- Explicitly mention that Azure CLI commands work cross-platform and provide guidance for Linux/Mac users (e.g., using 'cat' instead of 'Get-Content').
- Where PowerShell examples are given, provide equivalent Bash or shell script examples, especially for tasks like file conversion, reading/writing JSON, and variable assignment.
- Avoid using Windows-specific file paths in generic examples; use neutral or platform-agnostic paths, or provide both Windows and Linux versions.
- Clarify that PowerShell is available on Linux, but also provide native Linux shell alternatives for users who do not use PowerShell.
Create Pull Request