Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples for creating and managing Linux VMs with hibernation, but PowerShell examples are given equal prominence to CLI, despite PowerShell being a Windows-centric tool. The use of PowerShell is pervasive throughout, and in some cases, PowerShell is presented before or alongside CLI, which may create friction for Linux/macOS users who typically use Bash and CLI. There is also mention of 'git bash' for running Linux commands, which is a Windows tool, and may confuse native Linux users.
Recommendations
- Prioritize Azure CLI and Bash examples over PowerShell, as these are more native to Linux/macOS environments.
- Move PowerShell examples to a separate section or clearly mark them as relevant for Windows users managing Linux VMs remotely.
- Remove references to 'git bash' when instructing users to run commands on Linux; simply refer to the terminal or shell.
- Ensure all steps and examples can be completed using native Linux tools and workflows.
- Add explicit notes clarifying which examples are intended for Windows users and which for Linux/macOS users.
Create Pull Request