Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a strong Windows and PowerShell bias. All command-line examples and troubleshooting steps reference PowerShell cmdlets (e.g., Add-AzureRmEnvironment, connect-AzureRmAccount) and PowerShell-specific instructions. There are no CLI or Bash/Linux command equivalents provided, and Linux/Mac troubleshooting is only mentioned in the context of a certificate error, not as a first-class workflow. Instructions for validating client setup focus exclusively on PowerShell and Windows tools, with no mention of Azure CLI, Bash, or cross-platform alternatives.
Recommendations
- Provide equivalent Azure CLI (az) commands for all PowerShell cmdlet examples, and show both side-by-side where possible.
- Include Linux and macOS-specific instructions for client configuration, such as validating Python, OpenSSL, and certificate installation.
- Reference cross-platform tools (e.g., Azure CLI, Bash, SSH) in addition to or before Windows/PowerShell tools.
- Explicitly document any platform-specific differences or requirements, and ensure Linux/Mac users are not treated as an afterthought.
- Add troubleshooting steps and examples for common Linux/Mac issues beyond the single certificate store mention.
Create Pull Request