Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation presents PowerShell (Windows-centric) examples before Azure CLI (cross-platform) examples when describing how to create diagnostic settings for Azure Load Balancer. The PowerShell section is more detailed, with multiple scenarios (Log Analytics, Storage Account, Event Hub) and step-by-step variable assignments, while the Azure CLI section, though present, is listed after PowerShell. There are no Linux-specific shell examples (e.g., bash scripts), nor is there mention of platform-specific considerations for Linux users. The documentation implicitly prioritizes Windows tooling and patterns by leading with PowerShell.
Recommendations
- Present Azure CLI examples before PowerShell, or interleave them so that each scenario (Log Analytics, Storage, Event Hub) shows both CLI and PowerShell side-by-side.
- Explicitly state that Azure CLI is cross-platform and suitable for Linux, macOS, and Windows users.
- Add bash script examples or notes for Linux users, especially for common automation scenarios.
- Include a brief section or note on platform parity, clarifying that all operations can be performed from Linux, macOS, or Windows using Azure CLI.
- Avoid language or ordering that implies PowerShell is the default or preferred method unless there is a technical reason.