Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides configuration examples using Azure Portal, Azure CLI, and Azure PowerShell. While Azure CLI is cross-platform, PowerShell examples are given equal prominence and detail, despite being primarily a Windows-centric tool (though it is available on Linux, its usage is much more common on Windows). There are no explicit Linux shell (bash) examples, nor is there mention of Linux-specific tools or patterns. The documentation does not acknowledge Linux environments or provide guidance for Linux users beyond the CLI, which is presented generically. The presence of 'ms.custom: devx-track-azurepowershell' and the detailed PowerShell sections further reinforce a Windows bias.
Recommendations
- Add explicit bash examples for all CLI commands, showing usage in a typical Linux shell environment.
- Clarify that Azure CLI commands are cross-platform and provide notes or examples for running them in Linux/macOS terminals.
- Mention that PowerShell is available on Linux, but provide parity by including bash or shell script equivalents.
- Review documentation for references to Windows-specific tools or terminology and balance with Linux alternatives.
- Consider adding troubleshooting or configuration notes specific to Linux environments, such as differences in DNS client behavior or VM restart procedures.
Create Pull Request