Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation demonstrates a Windows bias in several ways: PowerShell is used as the primary CLI for both Windows and Linux examples, with commands and sample outputs shown from a Windows PowerShell prompt, even for Linux VMs. Windows-specific tools and file paths are referenced first and in more detail. Linux instructions are present but often rely on Windows-based tooling and lack parity in native Linux command-line examples (e.g., Azure CLI, Bash). There are missing Linux-native examples for deployment, tracking, and removal of extensions.
Recommendations
- Provide Linux-native command-line examples using Bash and Azure CLI (az) for all steps, including deployment, tracking, and removal of GPU extensions.
- Show sample outputs from a Linux terminal (e.g., bash prompt) for Linux VMs, rather than PowerShell on Windows.
- List Linux instructions and examples before or alongside Windows instructions, not after.
- Reference Linux file paths and tools (e.g., ~/.ssh, /var/log) in context, and avoid using Windows paths for Linux VM operations.
- Clarify that PowerShell Core is cross-platform, but also offer native Linux alternatives for users who do not use PowerShell.
- Ensure troubleshooting and verification steps include Linux-native commands and log file locations.
Create Pull Request