Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page exhibits a strong Windows bias. All troubleshooting examples and code snippets use PowerShell cmdlets (e.g., Connect-AzAccount, Get-AzVM, Invoke-RestMethod), which are native to Windows and not available by default on Linux. There are no Bash, Azure CLI, or Python examples, nor any mention of Linux-specific troubleshooting patterns or tools. The documentation implicitly assumes the user is running runbooks or troubleshooting from a Windows environment, and does not address Linux automation scenarios or provide parity for Linux users.
Recommendations
- Add equivalent troubleshooting steps and code examples using Azure CLI (az), Bash scripts, or Python SDK to support Linux users.
- Explicitly mention how to perform managed identity troubleshooting from Linux environments, including any differences in authentication or error messages.
- Where PowerShell cmdlets are referenced, provide side-by-side examples for Azure CLI and/or REST API calls.
- Clarify which steps or commands are platform-specific and offer alternatives for Linux/macOS users.
- Include notes or links to installing PowerShell Core on Linux if PowerShell is required, or recommend native Linux tools where possible.
Create Pull Request