Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias. PowerShell examples are provided for every operation, often with detailed output, while Linux/macOS-specific shell examples (e.g., Bash) are not shown. The only CLI examples use Azure CLI, which is cross-platform, but PowerShell (Windows-centric) is given equal or greater prominence, and Windows-specific requirements (e.g., page file on C:) are called out without Linux equivalents. There are no explicit Linux/macOS shell command examples, and the documentation assumes familiarity with Windows tools and patterns.
Recommendations
- Add explicit Bash or Linux/macOS shell examples for each operation, especially for viewing VM state and managing hibernation.
- Clarify that Azure CLI commands work on Linux/macOS, and provide sample outputs from those platforms.
- For OS configuration notes, include Linux-specific guidance (e.g., swap file or hibernation setup for Linux VMs).
- Balance PowerShell and CLI examples, and avoid giving PowerShell more detail or prominence than CLI.
- Where Windows-specific requirements are listed, add equivalent Linux/macOS requirements or explicitly state if none exist.
Create Pull Request