Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation consistently presents PowerShell examples first in each code tab, followed by Azure CLI and Terraform. PowerShell is a Windows-centric tool, and its prominence may suggest a Windows-first approach. There are no explicit Linux/macOS shell script examples (e.g., Bash), and installation instructions reference Azure PowerShell before Azure CLI. While Azure CLI and Terraform are cross-platform, the lack of native Linux/macOS shell examples and the ordering of examples may create friction for non-Windows users.
Recommendations
- Present Azure CLI examples before PowerShell, as CLI is more widely used across Linux/macOS.
- Add explicit Bash shell script examples for Linux/macOS users where appropriate.
- Clarify in prerequisites that Azure CLI and Terraform are fully supported on Linux/macOS, and provide installation links for those platforms.
- Consider balancing example order (e.g., rotate which tool appears first) or default to CLI for cross-platform parity.
- Explicitly mention that all steps can be performed on Linux/macOS using CLI and Terraform.
Create Pull Request