Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation presents Azure Portal (a GUI often associated with Windows) and Azure PowerShell examples before Azure CLI examples in every major section. PowerShell, a Windows-centric tool, is given equal or greater prominence than Azure CLI, which is more common on Linux/macOS. There are no explicit Linux/macOS-specific instructions, nor are Linux shell patterns (e.g., bash, sh) used in examples. The only mention of Linux is in the final VM creation CLI example, which sets --os-type linux, but this is not explained or highlighted for parity.
Recommendations
- Present Azure CLI examples before PowerShell examples, as CLI is more cross-platform and preferred by Linux/macOS users.
- Add explicit notes or sections for Linux/macOS users, clarifying that all CLI commands work natively on those platforms.
- Include bash/sh shell variable syntax in CLI examples (e.g., export, $VAR) instead of PowerShell variable syntax ($var), which may confuse Linux users.
- Where Portal instructions are given, clarify that the Portal is OS-agnostic and accessible from any browser.
- Add troubleshooting notes for Linux/macOS users if any step differs from Windows.
- Consider a dedicated 'Linux/macOS' tab or section if there are platform-specific nuances.
Create Pull Request