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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation provides examples for Azure CLI, Azure PowerShell, and the Azure Portal. While Azure CLI is cross-platform, Azure PowerShell is Windows-centric and is always presented alongside the CLI. There are no explicit Linux shell (e.g., Bash) or scripting examples, nor is there guidance for Linux-specific environments. The documentation does not clarify shell quoting/escaping differences, and PowerShell is given equal prominence to CLI, which may suggest a Windows bias.
Recommendations:
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and provide example shell environments (e.g., Bash, zsh).
- Add notes or examples for common Linux shell quoting/escaping issues, especially when embedding Kusto queries.
- If PowerShell examples are provided, consider also providing Bash or other Linux shell script equivalents for parity.
- Clarify in introductory sections that Azure CLI is the recommended cross-platform tool, and PowerShell is optional for Windows users.
- Where relevant, mention installation or usage differences for Linux users (e.g., package managers, environment variables).
Create pull request