Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page provides deployment instructions using PowerShell and Azure CLI, with explicit recommendations to run PowerShell locally in Visual Studio Code—a Windows-centric workflow. PowerShell examples are shown first in each code tab, and there are no Linux/macOS-specific instructions or examples for local environments. The use of Azure Cloud Shell and Azure CLI does provide cross-platform options, but the local workflow is biased toward Windows users. There is no mention of Linux/macOS-specific shell environments, nor troubleshooting for those platforms.
Recommendations
- Add explicit instructions for running Azure CLI and Bash scripts locally on Linux and macOS, including any prerequisites or differences in environment setup.
- Mention that Azure CLI is cross-platform and can be installed on Linux/macOS, with links to installation guides for those platforms.
- Provide examples of running deployment scripts in Bash or zsh on Linux/macOS, and clarify that PowerShell Core is available on Linux/macOS if users prefer PowerShell.
- Include troubleshooting tips for common issues encountered on Linux/macOS (e.g., file permissions, environment variables, authentication).
- Reorder code tabs so that Azure CLI (cross-platform) is shown before PowerShell, or present both equally.
Create Pull Request