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 more detailed output and interaction (e.g., confirmation prompts), while Linux/macOS-specific shell examples are not present. The CLI examples use Azure CLI, which is cross-platform, but there are no bash or shell script examples, nor any mention of Linux-specific considerations. Windows-specific notes (e.g., page file location on C:) are present, but there are no equivalent Linux guest OS configuration notes. PowerShell is given equal or greater prominence than CLI, and Windows terminology/tools are referenced without Linux parity.
Recommendations
- Add bash or shell script examples for common Linux/macOS workflows, especially for tasks like viewing VM state and managing hibernation.
- Include Linux guest OS configuration notes for hibernation, similar to the Windows page file note.
- Ensure that CLI examples explicitly mention their cross-platform nature and provide sample outputs for Linux/macOS terminals.
- Balance PowerShell and CLI coverage, and avoid giving PowerShell more detailed or interactive examples unless parity is provided for Linux users.
- Add troubleshooting or configuration tips for Linux-based VMs where relevant.
Create Pull Request