Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias by providing detailed PowerShell scripts for packaging and uploading the managed application artifacts, with no equivalent Bash or Linux shell examples. Windows tools and patterns (e.g., PowerShell cmdlets like New-AzStorageAccount, Set-AzStorageBlobContent) are presented first and exclusively for key steps such as uploading the application package. While Azure CLI examples are included for deployment, the initial artifact packaging and upload steps lack Linux parity, and there are no explicit instructions or examples for Linux users. This may hinder accessibility and usability for users on non-Windows platforms.
Recommendations
- Add Bash or Azure CLI examples for packaging and uploading the application zip to Azure Storage, using cross-platform tools (e.g., az storage blob upload, curl, or azcopy).
- Present Linux/macOS instructions alongside Windows/PowerShell instructions, or use tabs to separate platform-specific guidance.
- Avoid assuming PowerShell is the default or only scripting environment; clarify when steps are platform-specific.
- Reference cross-platform tools (e.g., azcopy, Azure CLI) before or alongside Windows-specific tools.
- Explicitly mention prerequisites for both Windows and Linux users, including installation of required tools.
Create Pull Request