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, while omitting equivalent Linux/macOS shell (bash) examples. Windows tools and patterns (e.g., PowerShell cmdlets like New-AzStorageAccount, Set-AzStorageBlobContent) are used exclusively or before any mention of cross-platform alternatives. There is no guidance for Linux users on how to perform these steps using bash, az CLI, or other platform-agnostic tools, which may hinder parity and accessibility for non-Windows users.
Recommendations
- Provide equivalent bash (Linux/macOS) scripts for packaging and uploading the application artifacts using Azure CLI commands (e.g., az storage account create, az storage container create, az storage blob upload).
- Clearly indicate which scripts are platform-specific and offer alternatives for each major OS.
- Avoid using Windows-specific tools (PowerShell cmdlets) as the only example; always include cross-platform Azure CLI commands where possible.
- Add a section or tab for Linux/macOS users in all code/script examples, especially for deployment and artifact upload steps.
- Review all instructions and ensure terminology and tooling are inclusive of Linux and macOS environments.
Create Pull Request