Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides step-by-step instructions and code samples for Azure CLI, Azure PowerShell, and the Azure portal. While Azure CLI is cross-platform, the inclusion of Azure PowerShell (which is historically Windows-centric and still most commonly used on Windows) alongside CLI in every example, and the lack of any Linux-specific shell (e.g., Bash) or scripting examples, indicates a bias toward Windows tooling and patterns. There are no examples using Bash, shell scripting, or Linux-native tools, nor is there any mention of Linux-specific considerations. The PowerShell examples are given equal prominence to CLI, and in some sections, PowerShell is listed before CLI, reinforcing a Windows-first approach. No explicit Linux guidance or troubleshooting is provided.
Recommendations
- Add explicit Bash/shell scripting examples for each CLI command, demonstrating usage in Linux environments (e.g., with environment variables, piping, jq for JSON parsing).
- Clarify that Azure CLI is cross-platform and provide guidance for installing and using it on Linux and macOS.
- Reorder sections to present Azure CLI examples before PowerShell, emphasizing cross-platform compatibility.
- Include notes or troubleshooting tips for Linux users, such as handling authentication, file paths, or common issues.
- Mention that PowerShell Core is available on Linux, but clarify differences or limitations compared to Windows PowerShell.
- Where screenshots are shown, include examples from Linux terminals or macOS, not just Windows/PowerShell environments.
Create Pull Request