Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation consistently presents both Azure CLI and Azure PowerShell examples for all major operations. However, there is a slight Windows bias: PowerShell (a Windows-centric tool) is always presented as an equal alternative to Azure CLI, and in some sections, environment variable examples use Windows syntax ($Env:...) before or alongside Linux syntax (export ...). There are no explicit Linux shell script examples, nor are Linux-native tools (e.g., bash, curl, systemd) mentioned. The documentation does not clarify which commands are best suited for Linux environments, and PowerShell is not natively available on most Linux distributions. Additionally, there are no explicit instructions for Linux-specific proxy configuration or troubleshooting.
Recommendations
- Add explicit Linux/Bash examples for environment variable configuration and command execution, especially for proxy setup.
- Clarify that Azure CLI commands are cross-platform and provide guidance for running them on Linux/macOS.
- When presenting environment variable setup, show Linux (export) syntax first, then Windows (PowerShell) syntax.
- Include troubleshooting tips for common Linux proxy issues (e.g., certificate stores, systemd-resolved).
- Mention that PowerShell is not installed by default on most Linux systems and provide installation instructions or alternatives.
- Consider adding a 'Platform differences' section to highlight any OS-specific considerations for Azure Arc gateway usage.
Create Pull Request