Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples for deployment and cleanup tasks, but PowerShell is a Windows-centric tool and is presented alongside Azure CLI without explicit Linux shell examples (e.g., Bash). There are no Linux-specific instructions, nor are Linux tools or shell patterns mentioned. The prerequisites mention Azure PowerShell before Azure CLI, and there is no mention of Linux-specific editors or shell environments. The documentation assumes Visual Studio Code, which is cross-platform, but does not discuss any Linux-specific considerations or alternatives.
Recommendations
- Add explicit Bash shell examples for Azure CLI commands, including shell syntax for Linux/macOS users (e.g., use $HOME, clear line continuations, etc.).
- Clarify that Azure CLI commands work natively on Linux/macOS and provide any necessary environment setup instructions for those platforms.
- Reorder prerequisites to mention Azure CLI before Azure PowerShell, as CLI is cross-platform and PowerShell is more Windows-centric.
- Include notes or sections for Linux/macOS users, such as using terminal editors (vim, nano) or running commands in Bash.
- Where PowerShell is mentioned, clarify its cross-platform availability or provide alternative instructions for native Linux shells.
Create Pull Request