Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all steps, but PowerShell is a Windows-centric tool and is listed as a primary method alongside Azure CLI. There is no mention of Linux-specific shell usage (e.g., Bash), nor are there examples tailored for Linux environments (such as using Bash variables, file paths, or package managers). The documentation assumes PowerShell is available and does not clarify that Azure CLI is cross-platform while PowerShell is primarily Windows-focused. Additionally, PowerShell is introduced as a prerequisite before Linux alternatives are discussed.
Recommendations
- Clarify that Azure CLI is cross-platform and works natively on Linux, macOS, and Windows.
- Provide explicit Bash shell examples for Linux/macOS users, using standard Bash variable syntax and file paths.
- Note that PowerShell is primarily a Windows tool, and recommend Azure CLI for Linux/macOS users.
- Add installation instructions for Azure CLI on Linux and macOS, including package manager commands (e.g., apt, yum, brew).
- Reorder prerequisites and examples to present Azure CLI (Linux-friendly) before PowerShell (Windows-centric).
- Avoid assuming PowerShell is available on all platforms; mention alternatives or platform-specific instructions.
Create Pull Request