Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents Windows-related examples and tools (PowerShell) before their Linux equivalents (Azure CLI) in several places. For example, in the 'Checklist for using your virtual network' section, PowerShell examples are consistently listed after Azure CLI, but the links for Windows and PowerShell are present throughout. Additionally, the 'Required permissions' section lists both CLI and PowerShell, but PowerShell is called out specifically for Windows users. There is also an 'IMPORTANT' note that is Windows-specific (WinRM configuration), while no equivalent Linux-specific caveat is provided.
Recommendations
- Ensure Linux/Azure CLI examples are presented first or equally alongside Windows/PowerShell examples.
- Add Linux-specific notes or caveats where Windows-specific ones are present (e.g., SSH configuration impacts).
- Where possible, clarify that PowerShell is available cross-platform, or provide Bash examples for Linux/macOS users.
- Review linked example pages to ensure Linux and Windows parity in depth and clarity.
Create Pull Request