Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides examples for Azure portal, PowerShell, and Azure CLI. PowerShell examples are detailed and prominent, and PowerShell is a Windows-centric tool. PowerShell examples are consistently presented before Azure CLI, which is more cross-platform. There are no Linux/macOS-specific shell examples (e.g., Bash), nor is there mention of Linux-specific tooling or considerations. The documentation assumes familiarity with PowerShell and Windows patterns, which may create friction for Linux/macOS users.
Recommendations
- Present Azure CLI examples before PowerShell examples, as CLI is cross-platform and more familiar to Linux/macOS users.
- Add explicit Bash shell examples for Azure CLI commands, including variable assignment and command chaining, to demonstrate usage in Linux/macOS environments.
- Clarify that PowerShell is available cross-platform, but note that Azure CLI is often preferred on Linux/macOS.
- Include troubleshooting or environment setup notes for Linux/macOS users (e.g., installation instructions for Azure CLI on Linux/macOS).
- Avoid language or patterns that assume a Windows environment (e.g., referencing Windows-specific paths or behaviors).
Create Pull Request