Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits a strong Windows bias. All command-line examples and management steps rely exclusively on PowerShell cmdlets, with no equivalent Linux shell commands or cross-platform CLI alternatives provided. The workflow and troubleshooting steps are centered around Windows tools and patterns, and Windows terminology (such as 'cmdlet') is used throughout. While the prerequisites mention that both Windows and Linux VHDs are supported, there are no Linux-specific instructions or examples for device management, VM deployment, or NUMA configuration. The documentation assumes the use of PowerShell and Windows-centric interfaces for all advanced configuration tasks.
Recommendations
- Provide equivalent Linux shell (bash) commands for all PowerShell examples, or clarify if PowerShell Core is required and available on Linux.
- Include instructions for connecting to the device and managing NUMA/vCPU reservations using Linux tools or Azure CLI, if supported.
- Explicitly document any platform limitations (e.g., if only PowerShell is supported for device management, state this clearly).
- Add Linux-focused examples for VM deployment, including screenshots or terminal output from a Linux environment.
- Where possible, use cross-platform tools (such as Azure CLI or REST API) in examples before or alongside PowerShell.
- Review terminology to ensure it is inclusive of Linux users (e.g., avoid assuming 'cmdlet' is familiar to all readers).
Create Pull Request