Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples for configuring diagnostic settings, but PowerShell is given equal prominence despite being Windows-centric. There is no explicit Linux shell (bash) example, and PowerShell is listed as a primary method alongside CLI and REST. The guidance does not mention Linux-specific considerations or alternative Linux-native tools, and PowerShell is presented as a recommended SDK for non-portal configuration, which may create friction for Linux/macOS users.
Recommendations
- Add explicit bash shell examples for configuring diagnostic settings using Azure CLI, demonstrating usage on Linux/macOS.
- Clarify that PowerShell examples are for Windows users, and recommend Azure CLI for cross-platform usage.
- Reorder examples to present CLI (cross-platform) before PowerShell, and explicitly state CLI is recommended for Linux/macOS.
- Include a note about installing and using Azure CLI on Linux/macOS.
- If PowerShell is required for any advanced scenario, explain how to use PowerShell Core on Linux/macOS.
Create Pull Request