Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation provides examples for Azure Portal, CLI, PowerShell, and REST API. PowerShell is featured as a primary scripting option alongside CLI, but there is no mention of Linux shell scripting (e.g., Bash) or Linux-specific patterns. The CLI examples are cross-platform, but PowerShell is Windows-centric and presented as an equal alternative. REST API examples use Windows-centric resource names and images, and the FAQ and backup management instructions reference the portal with Windows-style navigation. There are no explicit Linux/macOS shell examples, and Windows tools (PowerShell) are given equal prominence to CLI, which may create friction for Linux/macOS users.
Recommendations
- Add explicit Bash shell examples for common operations, especially for updating and deleting VMs and resources.
- Clarify that Azure CLI commands are cross-platform and can be run on Linux/macOS terminals.
- In REST API examples, use neutral or Linux-centric image references and OS types where appropriate.
- In PowerShell sections, add notes for Linux users about alternatives (e.g., Azure CLI, Bash scripting).
- In FAQ and portal navigation, clarify that the portal is OS-agnostic and accessible from any browser.
- Consider reordering examples to present CLI (cross-platform) before PowerShell (Windows-centric).
Create Pull Request