Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page exhibits several Windows-centric biases. All command-line examples use PowerShell, even for Linux VM scenarios, and are shown running from a Windows environment. Windows instructions and examples are presented before Linux equivalents. Windows-specific tools and paths (e.g., PowerShell cmdlets, Windows directory paths) are referenced exclusively or predominantly, while Linux shell commands and Linux-native tooling are missing. There are no examples of using Bash, Azure CLI, or Linux-native environments for deployment or management, and Linux output samples are minimal compared to Windows.
Recommendations
- Provide equivalent examples using Bash and Azure CLI for Linux users, including deployment and extension management commands.
- Show Linux-native environments (e.g., terminal output from Ubuntu or RHEL) for Linux scenarios, rather than running everything from Windows.
- Present Linux and Windows instructions in parallel, or alternate which comes first, to avoid implicit prioritization.
- Include Linux-specific file paths and log locations with the same detail as Windows examples.
- Reference Linux tools and patterns (e.g., shell scripting, use of sudo, file permissions) where relevant.
- Clarify that PowerShell is not required for Linux VM management and highlight cross-platform options.
Create Pull Request