Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples, but there is a notable bias toward Windows/PowerShell usage. PowerShell is given equal or sometimes more detailed coverage than Bash/Linux equivalents, and in some cases, PowerShell syntax is shown without clarifying that it is Windows-specific. There are no explicit Bash or Linux shell examples, and the CLI examples do not demonstrate Linux-specific patterns or considerations. The PowerShell section is detailed and assumes familiarity, while Linux/Bash users are left to infer usage from generic CLI commands. Additionally, the documentation refers to 'Azure PowerShell console' as an option for running CLI commands, which may confuse Linux users.
Recommendations
- Explicitly provide Bash/Linux shell examples for all Azure CLI commands, including variable assignment and command chaining.
- Clarify in each code block whether the example is for Windows (PowerShell) or Linux/macOS (Bash), especially where syntax differs.
- Avoid presenting PowerShell examples before or with more detail than Bash/Linux equivalents; strive for parity in depth and clarity.
- Add notes or sections for Linux/macOS users, highlighting any differences in environment setup, authentication, or command usage.
- Where possible, include screenshots or terminal output from both Windows and Linux environments to illustrate cross-platform usage.
Create Pull Request