Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a strong Windows bias. All deployment and management examples use PowerShell commands, even for Linux VMs, and are shown from a Windows environment (e.g., PS C:\WINDOWS\system32>). Windows-specific tools and paths are referenced first and in more detail. Linux instructions lack parity in terms of native tooling (e.g., Azure CLI or Bash), and Linux file paths and shell environments are not shown in deployment/removal steps. There are no examples of using Linux-native tools or running commands from a Linux client.
Recommendations
- Provide Linux-native examples using Bash and Azure CLI for deploying, tracking, and removing extensions.
- Show command-line examples run from a Linux environment (e.g., bash shell, Linux file paths) rather than only from Windows PowerShell.
- Include Linux-specific details for extension output and log file locations, matching the detail given for Windows.
- Present Linux and Windows instructions in parallel, giving equal prominence to both platforms.
- Reference cross-platform tools (e.g., Azure CLI) before or alongside Windows-specific tools.
- Clarify which steps are platform-agnostic and which are platform-specific, and avoid assuming the user is on Windows.
Create Pull Request