About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a Windows bias by providing a detailed PowerShell script for packaging and uploading the application artifacts to Azure Storage, without offering a Linux/bash equivalent. The PowerShell script uses Az PowerShell cmdlets and Windows-specific patterns, and it is presented before the Azure CLI and Portal instructions. There are no bash or cross-platform shell examples for the packaging/upload step, and the documentation assumes familiarity with Windows tooling.
Recommendations:
- Provide a bash (Linux/macOS) script example for packaging and uploading the application artifacts to Azure Storage, using Azure CLI commands (e.g., az storage account create, az storage container create, az storage blob upload).
- Clearly indicate which steps are platform-specific and offer alternatives for both Windows and Linux/macOS users.
- Consider presenting cross-platform Azure CLI examples before or alongside PowerShell examples to avoid the impression of Windows-first bias.
- Where possible, use Azure CLI as the default for scripting, as it is cross-platform, and relegate PowerShell to a separate tab or section.
- Explicitly mention that the PowerShell script is for Windows users and provide guidance for Linux/macOS users.
Create pull request