Bias Analysis
Detected Bias Types
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several ways. All command-line examples use Azure CLI (az) and jq, but the authentication and scripting patterns are tailored to Windows/PowerShell users (e.g., az account get-access-token, az account list), with no mention of Linux-specific authentication or shell differences. There are no Linux-specific examples, nor any explicit instructions for Linux users (e.g., bash, environment variables, authentication via service principals, or curl usage differences). The documentation references Azure tools and workflows that are most familiar to Windows administrators, and does not provide parity for Linux workflows or alternative CLI tools.
Recommendations
- Add explicit Linux shell examples, including bash syntax and authentication via service principals or environment variables.
- Clarify that Azure CLI and jq are cross-platform, and provide installation instructions for Linux.
- Include notes on differences in shell scripting between Windows (PowerShell) and Linux (bash), especially for environment variable handling and command substitution.
- Provide alternative examples using native Linux tools (e.g., curl with direct token injection, using environment variables for authentication).
- Mention Linux-specific considerations for NFS mounts, permissions, and SAP HANA deployment steps.
- Ensure that any references to Azure tools or workflows are accompanied by Linux usage notes or alternatives.
Create Pull Request