Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates a Windows bias by consistently listing PowerShell (a Windows-centric tool) examples and instructions before Azure CLI, and by recommending Visual Studio Code (a Microsoft product) as the editor. The use of PowerShell-specific concepts (such as splatting) and output examples is prominent. There is no mention of Linux-native editors or shell environments, and no explicit guidance for Linux or macOS users, even though Azure CLI is cross-platform.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first, as it is cross-platform and more familiar to Linux/macOS users.
- Explicitly mention that both Azure CLI and PowerShell are available on Windows, Linux, and macOS, and provide installation links for all platforms.
- Include instructions or examples using native Linux/macOS editors (e.g., nano, vim) alongside Visual Studio Code, or clarify that any text editor can be used.
- Avoid PowerShell-specific terminology (like 'splatting') without providing equivalent explanations for Bash or shell scripting.
- Add a brief section or note addressing Linux/macOS users, confirming that all steps are supported on their platforms and highlighting any differences if they exist.
Create Pull Request