Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both PowerShell and Azure CLI examples for deploying resources, but PowerShell instructions and terminology are presented first in each section. The instructions suggest running code in PowerShell locally in Visual Studio Code, which is a Windows-centric workflow. There is no explicit mention of Linux/macOS compatibility for PowerShell, nor are Bash shell or Linux-specific instructions prioritized or highlighted. The use of screenshots and UI walkthroughs is platform-neutral, but command-line guidance leans toward Windows-first patterns.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to reflect cross-platform parity.
- Explicitly state that Azure CLI commands work on Linux/macOS and Windows, and clarify that PowerShell Core is available cross-platform if relevant.
- Include Bash shell examples for common tasks, especially for resource deployment, to better support Linux users.
- Add notes or callouts for Linux/macOS users regarding any platform-specific considerations (e.g., authentication, environment setup).
- Where Visual Studio Code is mentioned, clarify that it is available on Linux/macOS and Windows.
Create Pull Request